Freigeben über

  • Artikel

Get-CsDialPlan

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Sätzen mit Wähleinstellungen zurück.

Syntax

Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Über dieses Cmdlet werden Informationen zu einem oder mehreren Sätzen mit Wähleinstellungen (auch als Standortprofile bezeichnet) in einer Organisation zurückgegeben. Wähleinstellungen bieten die erforderlichen Informationen für Enterprise-VoIP-Benutzer, damit diese Anrufe tätigen können. Wähleinstellungen werden von der Konferenzzentrale zudem für Einwahlkonferenzen verwendet. Über einen Satz mit Wähleinstellungen wird u. a. bestimmt, welche Normalisierungsregeln angewendet werden und ob für externe Anrufe ein Präfix gewählt werden muss.

Hinweis: Über Get-CsDialPlan können spezifische Informationen zu den Normalisierungsregeln eines Satzes mit Wähleinstellungen abgerufen werden. Wenn dies jedoch die einzige Information zu einem Satz mit Wähleinstellungen ist, die Sie benötigen, können Sie auch das Cmdlet Get-CsVoiceNormalizationRule verwenden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für den Gültigkeitsbereich, und bei einem Benutzerbereich ein Name, zur Identifizierung der abzurufenden Wähleinstellungen.

Filter

Optional

Zeichenfolge

Führt eine Platzhaltersuche aus, mit der die Ergebnisse auf Sätze mit Wähleinstellungen beschränkt werden können, deren Identitätswerte mit der angegebenen Platzhaltersuchzeichenfolge übereinstimmen.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zu den Wähleinstellungen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit diesem Cmdlet werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile" zurückgegeben.

Beispiel

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

Get-CsDialPlan

In Beispiel 1 wird eine Auflistung aller Sätze mit Wähleinstellungen zurückgegeben, die zur Verwendung in Ihrer Organisation konfiguriert sind. Zu diesem Zweck wird Get-CsDialPlan ohne zusätzliche Parameter aufgerufen.

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

Get-CsDialPlan -Identity RedmondDialPlan

In Beispiel 2 wird der Identitätswert verwendet, um die abgerufenen Daten auf Sätze mit Wähleinstellungen zu beschränken, die über benutzerbasierte Wähleinstellungen mit der Identität "RedmondDialPlan" verfügen. Da Identitätswerte eindeutig sein müssen, wird über diesen Befehl nur der angegebene Satz mit Wähleinstellungen zurückgegeben.

-------------------------- Beispiel 3 --------------------------

Get-CsDialPlan -Identity site:Redmond

Beispiel 3 ist mit Beispiel 2 identisch, nur dass hier statt eines benutzerbasierten Satzes mit Wähleinstellungen ein einem Standort zugewiesener Satz mit Wähleinstellungen abgerufen wird. Hierzu wird der Wert "site:" gefolgt vom Standortnamen (in diesem Fall "Redmond") des abzurufenden Standorts angegeben.

-------------------------- Beispiel 4 --------------------------

Get-CsDialPlan -Filter tag:*

In diesem Beispiel wird der Parameter "Filter" verwendet, um eine Auflistung aller Sätze mit Wähleinstellungen zurückzugeben, die auf Benutzerebene konfiguriert wurden. (Einstellungen, die auf Benutzerebene bzw. mit dem Gültigkeitsbereich "tag" erstellt werden, können Benutzern oder Gruppen direkt zugewiesen werden.) Die Platzhalterzeichenfolge "tag:*" weist das Cmdlet an, nur Sätze mit Wähleinstellungen zurückzugeben, deren Identitätswert mit dem Zeichenfolgenwert "tag:" beginnt und damit kennzeichnet, dass es sich um einen benutzerbasierten Satz mit Wähleinstellungen handelt.

-------------------------- Beispiel 5 --------------------------

Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

In diesem Beispiel werden die Normalisierungsregeln angezeigt, die von den zur Verwendung in Ihrer Organisation konfigurierten Sätzen mit Wähleinstellungen verwendet werden. Da die Eigenschaft "NormalizationRules" eine Reihe von Objekten umfasst, wird üblicherweise nicht der vollständige Satz an Normalisierungsregeln angezeigt. Um alle Regeln anzuzeigen, verwendet der Befehl in diesem Beispiel zunächst Get-CsDialPlan zum Abrufen einer Auflistung aller Sätze mit Wähleinstellungen. Diese Auflistung wird dann an das Cmdlet Select-Object weitergeleitet. Der Parameter "ExpandProperty" von Select-Object wird dann zum "Erweitern" der in der Eigenschaft "NormalizationRules" gefundenen Werte verwendet. Das Erweitern der Werte bedeutet lediglich, dass alle Normalisierungsregeln einzeln auf dem Bildschirm angezeigt werden. Dabei handelt es sich um dieselbe Ausgabe, die beim Aufruf von Get-CsVoiceNormalizationRule angezeigt wird.

-------------------------- Beispiel 6 --------------------------

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}

In Beispiel 6 werden Get-CsDialPlan und Where-Object verwendet, um eine Auflistung aller Sätze mit Wähleinstellungen abzurufen, deren Beschreibung das Wort "Redmond" enthält. Zu diesem Zweck verwendet der Befehl zunächst Get-CsDialPlan, um alle Sätze mit Wähleinstellungen abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das einen Filter anwendet, um die zurückgegebenen Daten auf Profile mit dem Wort "Redmond" in der Beschreibung zu beschränken.