• Artikel

Remove-CsOutboundTranslationRule

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine bestehende ausgehende Übersetzungsregel. Eine ausgehende Übersetzungsregel konvertiert Telefonnummern in das lokale Wählformat, um die Interaktion mit Nebenstellenanlagen (Private Branch Exchange, PBX) zu ermöglichen.

Syntax

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

Detaillierte Beschreibung

Rufen Sie dieses Cmdlet auf, um eine bestehende ausgehende Übersetzungsregel zu entfernen. Microsoft Lync Server 2010 normalisiert Telefonnummern in das E.164-Format. Viele Nebenstellenanlagen können dieses Format allerdings nicht verarbeiten. Ausgehende Übersetzungsregeln übersetzen die Nummer in das lokale Wählformat, bevor sie diese an den Vermittlungsserver oder an das Gateway senden.

Jede ausgehende Übersetzungsregel ist einer Trunkkonfiguration zugeordnet. Beim Entfernen einer Regel mithilfe dieses Cmdlets wird die Regel daher aus der Trunkkonfiguration für den entsprechenden Gültigkeitsbereich entfernt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID für die ausgehende Übersetzungsregel, die entfernt werden soll. Der Identitätswert besteht aus dem Gültigkeitsbereich, gefolgt von einem eindeutigen Namen in jedem Gültigkeitsbereich. Beispiel: site:Redmond/OutboundRule1.

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.Settings.TrunkConfiguration.TranslationRule-Objekt. Akzeptiert eine weitergeleitete Eingabe von Objekten für ausgehende Übersetzungsregeln.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Es entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule".

Beispiel

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

Remove-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"

In diesem Beispiel wird eine vorhandene ausgehende Übersetzungsregel für den Standort "Redmond" mit dem Namen "Prefix Redmond" entfernt. Da Identitäten eindeutig sind, wird über diesen Befehl eine einzige Regel gelöscht.

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

Get-CsOutboundTranslationRule -Filter site:* | Remove-CsOutboundTranslationRule

In diesem Beispiel werden alle ausgehenden Übersetzungsregeln auf Standortebene entfernt. Im ersten Teil des Befehls wird Get-CsOutboundTranslationRule mit dem Filterwert "site:*" aufgerufen, um eine Auflistung aller Regeln zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese Auflistung wird dann an das Cmdlet Remove-CsOutboundTranslationRule weitergeleitet, das jede Regel in der Auflistung entfernt.