Freigeben über

  • Artikel

Grant-CsDialPlan

 

Letztes Änderungsdatum des Themas: 2012-03-23

Weist einem oder mehreren Benutzern oder Gruppen einen Satz mit Wähleinstellungen zu.

Syntax

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

Detaillierte Beschreibung

Über dieses Cmdlet wird einem Benutzer ein vorhandener benutzerspezifischer Satz mit Wähleinstellungen zugewiesen Wähleinstellungen bieten die erforderlichen Informationen für Enterprise-VoIP-Benutzer, damit diese Anrufe tätigen können. Benutzer ohne gültige Wähleinstellungen können über Enterprise-VoIP keine Anrufe tätigen. Über einen Satz mit Wähleinstellungen wird z. B. festgelegt, wie Normalisierungsregeln angewendet werden und ob für externe Anrufe eine Vorwahl gewählt werden muss.

Zum Prüfen, ob einem Benutzer ein benutzerbasierter Satz mit Wähleinstellungen zugewiesen wurde, rufen Sie einen Befehl mit dem folgenden Format auf: Get-CsUser "<Benutzername>" | Select-Object DialPlan. Beispiel:

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

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Grant-CsDialPlan lokal ausfü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-CsDialPlan"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Die Identität (eindeutige ID) des Benutzers, dem der Satz mit Wähleinstellungen zugewiesen wird.

Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) 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 Identitätswert der Wähleinstellungen, die dem Benutzer zugewiesen werden sollen. (Beachten Sie, dass nur der Namensteil der Identität verwendet wird. Identitätswerte für Wähleinstellungen auf Benutzerbasis verwenden das Präfix "tag:", das nicht in "PolicyName" eingeschlossen werden darf.)

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 mit dem Identitätswert eines Benutzerkontos, dem die Wähleinstellungen zugeordnet werden.

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-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

Im oben gezeigten Beispiel wird Grant-CsDialPlan verwendet, um dem Benutzer mit der Identität (in diesem Fall dem Anzeigenamen) "Ken Myer" die Wähleinstellungen "RedmondDialPlan" zuzuweisen.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

In Beispiel 2 wird der Satz mit Wähleinstellungen "RedmondDialPlan" allen Benutzern mit einem Büro in der Stadt "Redmond" zugewiesen. Hierzu wird das Cmdlet Get-CsUser zum Abrufen einer Auflistung aller Benutzer mit einem Büro in der Stadt Redmond aufgerufen. Zu diesem Zweck werden der Parameter "LDAPFilter" und die LDAP-Abfrage "l=Redmond" verwendet. (In der von Active Directory-Domänendienste (AD DS) verwendeten LDAP-Abfragesprache steht "l" für den Ort des Benutzers.) Diese Auflistung wird anschließend an das Cmdlet Grant-CsDialPlan weitergeleitet, das allen Benutzern in der Auflistung die Wähleinstellungen "Redmond" zuweist.