Freigeben über

  • Artikel

Set-CsHostedVoicemailPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine gehostete Voicemailrichtlinie.

Syntax

Set-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Set-CsHostedVoicemailPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit diesem Cmdlet wird eine Richtlinie geändert, um ein für Microsoft Lync Server 2010 oder Microsoft Office Communications Server aktiviertes Benutzerkonto so zu konfigurieren, dass es einen gehosteten Exchange Unified Messaging (UM)-Voicemaildienst verwendet. Die Richtlinie legt fest, wie nicht beantwortete Anrufe des Benutzers an einen gehosteten Exchange UM-Dienst weitergeleitet werden.

Ein Benutzer muss für gehostete Exchange UM-Voicemail aktiviert sein, damit diese Richtlinie wirksam wird. Um zu ermitteln, ob ein Benutzer für gehostete Voicemail aktiviert ist, können Sie das Cmdlet Get-CsUser aufrufen und die Eigenschaft "HostedVoiceMail" überprüfen. (Der Wert "True" bedeutet, dass der Benutzer aktiviert ist.)

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsHostedVoicemailPolicy lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHostedVoicemailPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Die eindeutige ID der gehosteten Voicemailrichtlinie, die geändert werden soll. Diese ID umfasst den Gültigkeitsbereich (im Fall von globalen Richtlinien), den Gültigkeitsbereich und den Standort (für eine Richtlinie auf Standortebene, z. B. "site:Redmond") oder den Richtliniennamen (für eine benutzerbasierte Richtlinie, z. B. "HVUserPolicy").

Instance

Optional

HostedVoicemailPolicy

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. Das Objekt muss ein Objekt vom Typ "HostedVoicemailPolicy" sein und kann durch Aufrufen des Cmdlets Get-CsHostedVoicemailPolicy abgerufen werden.

Description

Optional

Zeichenfolge

Eine kurze Beschreibung der Richtlinie.

Destination

Optional

Zeichenfolge

Der diesem Parameter zugewiesene Wert ist der vollqualifizierte Domänenname des gehosteten Exchange UM-Diensts.

Wenn Sie versuchen, einen Benutzer für gehostete Voicemail zu aktivieren, und die zugewiesene Richtlinie des Benutzers nicht über den Wert "Destination" verfügt, tritt bei der Aktivierung ein Fehler auf.

Dieser Wert darf maximal 255 Zeichen umfassen und muss ein Format aufweisen, das mit dem regulären Ausdruck ^[a-zA-Z0-9\-_]+(\.[a-zA-Z0-9\-_]+){0,}$ übereinstimmt. Das bedeutet, dass er als vollqualifizierter Domänenname angegeben werden muss, z. B. "server.litwareinc.com".

Organization

Optional

Zeichenfolge

Dieser Parameter enthält eine durch Trennzeichen getrennte Liste der Exchange-Mandanten mit Lync Server 2010-Benutzern. Für jeden Mandanten muss der vollqualifizierte Domänenname des Mandanten im gehosteten Exchange-Dienst angegeben werden.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von gehosteten VoIP-Richtlinienobjekten.

Rückgabetypen

Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy" geändert.

Beispiel

-------------------------- Beispiel 1 --------------------------

Set-CsHostedVoicemailPolicy -Identity ExRedmond -Destination ExUM.contoso.com

Dieser Befehl ändert die Eigenschaft "Destination" der gehosteten Voicemailrichtlinie "ExRedmond". Das Exchange UM-Ziel für diese Richtlinie wird auf den vollqualifizierten Domänennamen "ExUM.contoso.com" festgelegt.

-------------------------- Beispiel 2 --------------------------

$a = (Get-CsHostedVoicemailPolicy -Identity ExRedmond).Organization
$a += ",corp3.litwareinc.com"
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Organization $a

Dieser Befehl fügt einen Exchange-Mandanten zur durch Trennzeichen getrennten Liste der Mandanten (Organisationen) für die Richtlinie "ExRedmond" hinzu. Die erste Zeile ruft Get-CsHostedVoicemailPolicy auf, um die Richtlinie mit dem Identitätswert "ExRedmond" abzurufen. Der Cmdlet-Aufruf wird in Klammern eingeschlossen, da zunächst die Richtlinie abgerufen werden muss. Es wird anschließend die punktierte Schreibweise verwendet, um die Eigenschaft "Organization" der Richtlinie abzurufen. Die zurückgegebene Zeichenfolge wird in der Variablen "$a" gespeichert. In der nächsten Zeile wird der Operator "+=" verwendet, um die zugewiesene Zeichenfolge (,corp3.litwareinc.com) an das Ende der in der Variablen "$a" gespeicherten Zeichenfolge anzuhängen. (Beachten Sie das Komma in der zugewiesenen Zeichenfolge. "Organization" ist eine durch Trennzeichen getrennte Liste. Wenn daher bereits ein Wert in der Liste vorhanden ist, muss für zusätzliche Werte ein Komma vorangestellt werden.) In der letzten Zeile wird schließlich Set-CsHostedVoicemailPolicy aufgerufen und die neue Zeichenfolge "Organization" zugewiesen, indem die Variable "$a" an den Parameter "Organization" übergeben wird.