Freigeben über

  • Artikel

Set-CsOutboundTranslationRule

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert 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

Set-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Set-CsOutboundTranslationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

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. Rufen Sie dieses Cmdlet auf, um eine bestehende ausgehende Übersetzungsregel zu ändern.

Jede ausgehende Übersetzungsregel ist einer Trunkkonfiguration zugeordnet. Die Verwendung dieses Cmdlets zum Ändern einer Regel hat daher Auswirkungen auf die entsprechende Trunkkonfiguration. Es ist möglich, jeder Konfiguration mehrere ausgehende Übersetzungsregeln zuzuordnen. Der Identitätswert jeder Regel besteht daher aus einem Gültigkeitsbereich und einem innerhalb des Gültigkeitsbereichs eindeutigen Namen (im Format "Gültigkeitsbereich/Name", z. B. "site:Redmond/OBR1"). Die Regel wird automatisch der Trunkkonfiguration im gleichen Gültigkeitsbereich zugeordnet. Zum Ändern der ausgehenden Übersetzungsregeln in einer Trunkkonfiguration wird Set-CsOutboundTranslationRule empfohlen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

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

Instance

Optional

TranslationRule

Ein Objektverweis auf eine ausgehende Übersetzungsregel. Dieses Objekt muss vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule" sein und kann durch Aufrufen von Get-CsOutboundTranslationRule abgerufen werden.

Description

Optional

Zeichenfolge

Eine aussagekräftige Beschreibung der ausgehenden Übersetzungsregel. Anhand dieser Beschreibung können Administratoren den Zweck der Regel einwandfrei erkennen.

Pattern

Optional

Zeichenfolge

Ein regulärer Ausdruck, der das Nummernmuster repräsentiert, für das die Übersetzung gilt.

Priority

Optional

Int32

Wenn eine Nummer dem Muster einer oder mehrerer ausgehender Übersetzungsregeln entspricht, werden die Regeln nach ihrer Priorität angewendet. Verwenden Sie diesen Parameter, um der Regel eine Priorität zuzuweisen.

Translation

Optional

Zeichenfolge

Ein regulärer Ausdruck, der auf die mit dem Muster übereinstimmende Nummer angewendet wird, um diese auf das Ausgangsrouting vorzubereiten.

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. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule" geändert.

Beispiel

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

Set-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond" -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

In diesem Beispiel wird die globale ausgehende Übersetzungsregel mit dem Identitätswert "site:Redmond/Prefix Redmond" geändert. Es enthält eine Beschreibung, die erläutert, dass diese Regel zur Übersetzung von Nummern im E.164-Format in eine siebenstellige Telefonnummer dient. Darüber hinaus wurden Muster- und Übersetzungswerte angegeben, die die bestehenden Werte dieser Eigenschaften ändern. Diese Werte übersetzen eine vom regulären Ausdruck im Muster angegebene Nummer im E.164-Format (in diesem Fall 12 Ziffern, die mit +1425 beginnen) durch Entfernen der ersten fünf Ziffern in eine siebenstellige Nummer. Die Nummer +14255551212 wird beispielsweise in 5551212 übersetzt.

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

$a = Get-CsOutboundTranslationRule -Identity "site:Redmond/OBR1"
$a.Name = "Outbound Rule 1"
Set-CsOutboundTranslationRule -Instance $a

In diesem Beispiel wird die Eigenschaft "Name" einer ausgehenden Übersetzungsregel geändert. Beachten Sie, dass damit der Identitätswert dieser Regel geändert wird. Der erste Befehl in diesem Beispiel ist ein Aufruf des Cmdlets Get-CsOutboundTranslationRule. Als Identitätswert wird "site:Redmond\OBR1" angegeben. Diese gibt eine einzelne Übersetzungsregel, die Regel mit dem Identitätswert, zurück. Statt diese Regel anzuzeigen, wird diese der Variablen "$a" zugewiesen. In Zeile 2 dieses Beispiels wird die Zeichenfolge "Outbound Rule 1" der Eigenschaft "Name" der Variablen "$a" zugewiesen. Diese Variable enthält einen Verweis auf "site:Redmond/OBR1". In der letzten Zeile dieses Beispiels wird Set-CsOutboundTranslationRule aufgerufen, das den Parameter "Instance" angibt und ihm die Variable "$a" übergibt. Wenn Sie nun Get-CsOutboundTranslationRule mit dem Identitätswert "site:Redmond/OBR1" aufrufen, wird nichts zurückgegeben. Grund hierfür ist, dass dieser Identitätswert nicht mehr vorhanden ist. Er wurde von der gleichen Regel ersetzt, die allerdings den Identitätswert "site:Redmond/Outbound Rule 1" hat.