Condividi tramite

  • Articolo

Remove-CsOutboundTranslationRule

 

Ultima modifica dell'argomento: 2012-03-25

Consente di eliminare una regola di conversione in uscita. Una regola di conversione in uscita converte i numeri telefonici nel formato di composizione locale per agevolare l'interazione con i sistemi PBX (Private Branch eXchange).

Sintassi

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

Descrizione dettagliata

Utilizzare questo cmdlet per eliminare una regola di conversione in uscita esistente. Microsoft Lync Server 2010 normalizza i numeri telefonici nel formato E.164. Tuttavia, molti sistemi PBX (Private Branch eXchange) non sono in grado di utilizzare questo formato. Le regole di conversione in uscita convertono il numero nel formato di composizione locale prima di inviarlo al Mediation Server o gateway.

Ciascuna regola di conversione in uscita è associata a una configurazione trunk. Ciò significa che l'utilizzo di questo cmdlet per rimuovere una regola comporterà la rimozione di questa regola dalla configurazione trunk dell'ambito corrispondente.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsOutboundTranslationRule può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

L'identificatore univoco della regola di conversione in uscita che si desidera rimuovere. L'identità è costituita dall'ambito seguito da un nome che deve essere univoco all'interno di ciascun ambito. Ad esempio, site:Redmond/OutboundRule1.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule. Accetta input tramite pipeline di oggetti regola di conversione in uscita.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Esempio

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

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

Questo esempio consente di rimuovere una regola di conversione in uscita esistente per il sito Redmond denominata Prefix Redmond. Le identità sono univoche, per cui questo comando eliminerà una sola regola.

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

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

Questo esempio consente di rimuovere tutte le regole di conversione in uscita a livello di sito. La prima parte del comando prevede l'utilizzo del cmdlet Get-CsOutboundTranslationRule con il valore del filtro site:* che restituisce una raccolta di tutte le regole la cui identità inizia con site:. Questa raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsOutboundTranslationRule che elimina ogni singola regola nella raccolta.