• Artikel

Remove-CsDialPlan

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt den angegebenen Satz mit Wähleinstellungen. Dieses Cmdlet kann zudem zum Entfernen des globalen Satzes mit Wähleinstellungen verwendet werden. Wenn Sie den globalen Satz mit Wähleinstellungen entfernen, werden die Einstellungen nicht wirklich entfernt, sondern nur auf ihre Standardwerte zurückgesetzt.

Syntax

Remove-CsDialPlan -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Über dieses Cmdlet wird ein vorhandener Satz mit Wähleinstellungen (auch als Standortprofil bezeichnet) entfernt. 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: Beim Entfernen eines Satzes mit Wähleinstellungen werden auch zugeordnete Normalisierungsregeln entfernt. Wenn der globale Satz mit Wähleinstellungen entfernt wird, werden die zugeordneten Normalisierungsregeln ebenfalls entfernt, es wird jedoch eine standardmäßige globale Normalisierungsregel erstellt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID des Satzes mit Wähleinstellungen, der entfernt werden soll.

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.LocationProfile-Objekt. Remove-CsDialPlan akzeptiert eine weitergeleitete Eingabe von Wähleinstellungsobjekten.

Rückgabetypen

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

Beispiel

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

Remove-CsDialPlan -Identity RedmondDialPlan

Im vorangehenden Beispiel wird Remove-CsDialPlan verwendet, um den benutzerbasierten Satz mit Wähleinstellungen mit der Identität "RedmondDialPlan" zu löschen. Beim Löschen eines Satzes mit Wähleinstellungen muss den Benutzern, die diesen Einstellungen zugeordnet waren, nicht unbedingt ein neuer Satz mit Wähleinstellungen zugewiesen werden. Stattdessen verwenden diese Benutzer den Satz mit Wähleinstellungen, der ihrem Dienst oder Standort zugewiesen ist, bzw. die globalen Einstellungen.

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

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

In Beispiel 2 werden alle Sätze mit Wähleinstellungen gelöscht, deren Beschreibung den Namen "Redmond" enthält. Zu diesem Zweck ruft der Befehl zunächst Get-CsDialPlan auf, um eine Sammlung aller Sätze mit Wähleinstellungen zurückzugeben, die zur Verwendung innerhalb der Organisation konfiguriert sind. Diese Sammlung 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. Diese gefilterten Daten werden anschließend an Remove-CsDialPlan übergeben, um alle Sätze mit Wähleinstellungen in dieser Sammlung zu entfernen.