Freigeben über

  • Artikel

Grant-CsHostedVoicemailPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Weist einzelnen Benutzern eine gehostete Voicemailrichtlinie zu. (Auf Benutzerebene können Sie individuellen Benutzern oder Gruppen Richtlinien zuweisen.)

Syntax

Grant-CsHostedVoicemailPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit diesem Cmdlet wird einem Benutzer eine vorhandene benutzerspezifische gehostete Voicemailrichtlinie zugewiesen. Eine gehostete Voicemailrichtlinie legt fest, wie nicht entgegengenommene Anrufe für Benutzer an einen gehosteten Exchange Unified Messaging (UM)-Dienst weitergeleitet werden.

Sie können überprüfen, ob einem Benutzer eine Voicemailrichtlinie auf Benutzerbasis zugewiesen wurde, indem Sie einen Befehl in diesem Format aufrufen: Get-CsUser "<Benutzername>" | Select-Object HostedVoicemailPolicy. Beispiel:

Get-CsUser "Ken Myer" | Select-Object HostedVoicemailPolicy

Wenn Sie eine gehostete Voicemailrichtlinie ohne Ziel einem Benutzer zuweisen, können Sie diesen Benutzer für eine gehostete Voicemail nicht aktivieren.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Grant-CsHostedVoicemailPolicy lokal auszuführen: RTCUniversalUserAdmins. 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 "Grant-CsHostedVoicemailPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Der Identitätswert (die eindeutige ID) des Benutzers, dem die gehostete Voicemailrichtlinie zugewiesen wurde.

Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) Benutzerprinzipalname (User Principal Name, UPN) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer").

Sie können das Sternchen (*) als Platzhalterzeichen nutzen, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Wenn als Identität "* Smith" angegeben wird, werden z. B. alle Benutzer mit dem Familiennamen "Smith" zurückgegeben.

Vollständiger Datentyp: Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Optional

Zeichenfolge

Der Name (Identitätswert) der gehosteten Voicemailrichtlinie, die dem Benutzer zugewiesen werden soll. (Beachten Sie, dass nur der Namensteil der Identität verwendet wird. Die Identitätswerte für die auf Benutzerbasis gehostete Voicemailrichtlinie verwenden das Präfix "tag:". Dieses Präfix darf nicht in "PolicyName" eingeschlossen werden.)

DomainController

Optional

FQDN

Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet.

PassThru

Optional

Switch-Parameter

Gibt die Ergebnisse des Befehls zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

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

Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines Benutzerkontos repräsentiert, dem die gehostete Voicemailrichtlinie zugewiesen wird.

Rückgabetypen

Bei Verwendung mit dem Parameter "PassThru" wird ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact" zurückgegeben.

Beispiel

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

Grant-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond

In diesem Beispiel wird die gehostete Voicemailrichtlinie mit der Identität "ExRedmond" dem Benutzer mit dem Anzeigenamen "Ken Myer" zugewiesen.

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

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsHostedVoicemailPolicy -PolicyName ExRedmond

In diesem Beispiel wird die gehostete Voicemailrichtlinie mit dem Identitätswert "ExRedmond" allen Benutzern in der Organisationseinheit (OU) "Finance" zugewiesen: OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com. Der erste Teil des Befehls ruft das Cmdlet Get-CsUser auf, um alle für Lync Server 2010 oder Office Communications Server aktivierten Benutzer aus der angegebenen OU abzurufen. Diese Auflistung von Benutzern wird dann an das Cmdlet Grant-CsHostedVoicemailPolicy weitergeleitet, das jedem dieser Benutzer die Richtlinie "ExRedmond" zuweist.