Freigeben über

  • Artikel

Grant-CsVoicePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Weist eine VoIP-Richtlinie einer oder mehreren Benutzern oder Gruppen zu.

Syntax

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

Detaillierte Beschreibung

Über dieses Cmdlet wird einem Benutzer eine vorhandene VoIP-Richtlinie auf Benutzerbasis zugewiesen. VoIP-Richtlinien werden zum Verwalten von Enterprise-VoIP-bezogenen Funktionen verwendet, z. B. für das gleichzeitige Klingeln (die Möglichkeit, ein zweites Telefon läuten zu lassen, wenn jemand die Nummer Ihres Bürotelefons wählt) und die Anrufweiterleitung. Verwenden Sie dieses Cmdlet, um die Einstellungen zum Aktivieren und Deaktivieren dieser Funktionen für einen bestimmten Benutzer zuzuweisen.

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

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

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Die Identität (die eindeutige ID) des Benutzers, dem die Richtlinie 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), 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 VoIP-Richtlinie, die dem Benutzer zugewiesen werden soll. (Beachten Sie, dass nur der Namensteil der Identität verwendet wird. Die Identitätswerte für die benutzerdefinierte Richtlinie 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 darstellt, dem die VoIP-Richtlinie 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-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond

In diesem Beispiel wird die VoIP-Richtlinie mit der Identität "VoicePolicyRedmond" dem Benutzer mit dem Anzeigenamen "Ken Myer" zugewiesen.

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

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

In diesem Beispiel wird die VoIP-Richtlinie mit dem Identitätswert "VoicePolicyRedmond" allen Benutzer in der 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 anschließend an das Cmdlet Grant-CsVoicePolicy weitergeleitet, das jedem dieser Benutzer die Richtlinie "VoicePolicyRedmond" zuweist.