Condividi tramite

  • Articolo

Get-CsOutboundTranslationRule

 

Ultima modifica dell'argomento: 2012-03-23

Recupera una o più regole 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 e gateway PSTN.

Sintassi

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

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

Descrizione dettagliata

Chiamare questo cmdlet per recuperare una regola di conversione in uscita esistente. Microsoft Lync Server 2010 normalizza i numeri di telefono nel formato E.164. Numerosi sistemi PBX privati non sono tuttavia in grado di supportare questo formato. Le regole di conversione in uscita consentono di convertire il numero nel formato di composizione locale prima dell'invio del numero al Mediation Server o al gateway.

Ogni regola di conversione in uscita è associata a una configurazione del trunk. A ogni configurazione del trunk possono essere associate più regole 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.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsOutboundTranslationRule in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco della regola di conversione in uscita che si desidera recuperare. L'identità è costituita dall'ambito seguito da un nome univoco per ogni ambito (ad esempio site:Redmond/OutboundRule1). Con l'indicazione di un valore per Identity viene restituita al massimo una regola di conversione in uscita.

Filter

Facoltativo

Stringa

Consente di eseguire una ricerca con caratteri jolly che permette di circoscrivere i risultati alle regole di conversione in uscita le cui identità corrispondono alla stringa con caratteri jolly fornita.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare la regola di conversione in uscita dalla replica locale del archivio di gestione centrale anziché dal archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Questo cmdlet consente di recuperare uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Esempio

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

Get-CsOutboundTranslationRule

Con questo esempio vengono recuperate tutte le regole di conversione in uscita per la distribuzione di Lync Server 2010.

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

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

Con questo esempio viene recuperata una singola regola di conversione in uscita, quella con identità site:Redmond/Prefix Redmond.

-------------------------- Esempio 3 --------------------------

Get-CsOutboundTranslationRule -Filter site:*

Con questo esempio vengono recuperate tutte le regole di conversione in uscita a livello di sito. Il comando chiama Get-CsOutboundTranslationRule con un filtro uguale a site:* per restituire una raccolta di tutte le regole con valori di identità che iniziano con la stringa site:.