Condividi tramite

  • Articolo

New-CsOutboundTranslationRule

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova regola di conversione in uscita. Una regola di conversione in uscita consente di convertire i numeri di telefono nel formato di composizione locale per l'interazione con sistemi PBX (Private Branch Exchange).

Sintassi

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

New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Chiamare questo cmdlet per creare una nuova regola di conversione in uscita. Microsoft Lync Server 2010 normalizza i numeri di telefono al formato E.164. Numerosi sistemi PBX privati non sono tuttavia in grado di supportare questo formato. Le regole di conversione in uscita pertanto convertono il numero nel formato di composizione locale prima di inviarlo a Mediation Server o al gateway.

Ogni regola di conversione in uscita è associata a una configurazione del trunk. A ogni configurazione può essere associata più di una regola di conversione in uscita. Pertanto, l'identità per ogni regola è costituita da un ambito con un nome univoco per tale ambito nel formato ambito/nome, ad esempio site:Redmond/OBR1. La regola viene associata automaticamente alla configurazione del trunk con lo stesso ambito. Se si chiama New-CsOutboundTranslationRule e si specifica un ambito in cui non è stata ancora definita una configurazione trunk, verrà creata la configurazione trunk con l'ambito specificato, la regola di conversione in uscita e i valori predefiniti.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsOutboundTranslationRule i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsOutboundTranslationRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per la regola di conversione in uscita. Il parametro Identity include l'ambito in cui viene applicata la regola e il nome della regola e deve essere incluso nell'ambito globale, del sito o del servizio (solo PSTNGateway), ad esempio site:Redmond/OutboundRule1 e PstnGateway:Redmond.litwareinc.com/OutboundRule2.

Se il parametro Identity è specificato, non è possibile specificare valori per i parametri Name o Parent.

Parent

Obbligatorio

Stringa

Ambito della regola di conversione in uscita. Se viene specificato un valore per questo parametro è necessario specificare anche un valore per il parametro Name. Non è tuttavia possibile specificare il parametro Identity. Se non vengono specificati i parametri Parent e Name, è necessario specificare il parametro Identity.

Name

Obbligatorio

Stringa

Nome della regola di conversione in uscita. Se non viene fornito alcun nome, è necessario specificare un'identità formata da un ambito e nome. Se viene fornito un nome, è richiesto anche il parametro Parent ma non è possibile specificare un'identità.

Description

Facoltativo

Stringa

Descrizione della regola di conversione in uscita. Questa descrizione consente di identificare lo scopo della regola.

Pattern

Facoltativo

Stringa

Espressione regolare che rappresenta il formato del numero a cui la conversione verrà applicata.

Valore predefinito: ^\+(\d*)$

Priority

Facoltativo

Int32

Se un numero corrisponde al formato di più regole di conversione in uscita, le regole vengono applicate in ordine di priorità. Utilizzare questo parametro per assegnare una priorità alla regola.

Translation

Facoltativo

Stringa

Espressione regolare che verrà applicata al numero corrispondente al formato per preparare tale numero per il routing in uscita.

Valore predefinito: $1

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno.

Tipi restituiti

Questo cmdlet consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Esempio

-------------------------- Esempio 1 --------------------------

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

In questo esempio viene creata una regola di conversione in uscita per il sito Redmond denominata Prefix Redmond. Dal momento che non sono specificati altri parametri, la regola viene creata con i valori predefiniti. Il valore passato al parametro -Identity è racchiuso tra virgolette doppie perché il nome della regola (Prefix Redmond) contiene uno spazio. Se il nome della regola non contiene uno spazio non è necessario racchiudere il valore di Identity tra virgolette doppie.

-------------------------- Esempio 2 --------------------------

New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

In questo esempio viene creata una nuova regola di conversione in uscita globale denominata SeattleFourDigit. Nota: invece di specificare Parent e Name, è possibile creare la stessa regola specificando -Identity global/SeattleSevenDigit. È stata inclusa una descrizione in cui viene illustrato che questa regola è per la conversione di numeri dal formato E.164 al formato a sette cifre. Sono stati inoltre specificati i valori Pattern e Translation. Tali valori convertono un numero in formato E.164 (in questo caso 12 cifre che iniziano con +1425), specificato dall'espressione regolare in Pattern, in un numero di sette cifre rimuovendo le prime cinque cifre. Ad esempio, il numero +14255551212 verrebbe convertito nel numero 5551212.