Condividi tramite

  • Articolo

Remove-CsSipResponseCodeTranslationRule

 

Ultima modifica dell'argomento: 2012-03-26

Rimuove una regola di conversione del codice di risposta SIP. Queste regole consentono agli amministratori di mappare i codici di risposta SIP con valori compresi tra 400 e 699 ai valori utilizzati da Microsoft Lync Server 2010.

Sintassi

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

Descrizione dettagliata

Il trunking SIP consente di connettersi a una rete VoIP (Voice over Internet Protocol), quale VoIP aziendale, mediante PSTN (Public Switched Telephone Network). In Lync Server 2010Mediation Server utilizza i trunking peer per interagire con la rete PSTN. Se si verifica un errore di una chiamata in uscita sulla rete PSTN, viene automaticamente generato un codice di causa ISUP (ISDN User Part). Un gateway PSTN ad esempio può inviare un codice di causa 34 per indicare che non sono disponibili circuiti o canali per eseguire la chiamata. Quando un trunking peer di Mediation Server riceve tale codice di causa ISUP, lo converte in un codice di risposta SIP che viene quindi inviato a Mediation Server. In Lync Server questi codici di risposta vengono utilizzati per le decisioni per il routing in uscita. Ad esempio, a un gateway che non funziona correttamente potrebbe essere assegnato automaticamente uno stato di priorità secondaria per limitare l'uso di tale gateway e ottimizzare le possibilità di completare correttamente una chiamata.

Non in tutti i gateway tuttavia viene utilizzato il mapping consigliato tra codice di causa ISUP e codice di risposta SIP utilizzato da Lync Server. Per tali gateway, gli amministratori possono utilizzare i cmdlet CsSipResponseCodeTranslationRule per mappare il codice di risposta SIP del gateway SIP (insieme al codice di causa ISUP, se disponibile) a un codice di risposta SIP utilizzato da Lync Server. Ad esempio, un gateway potrebbe mappare il codice di causa ISUP 34 (nessun circuito/canale disponibile) al codice di risposta SIP 486 (non disponibile qui). In base a un codice di risposta 486, la logica del routing in uscita di Lync Server non tenterà di trovare un nuovo gateway per eseguire la chiamata.

Per Lync Server tuttavia il codice di risposta SIP 486 deve essere invece mappato al codice di risposta SIP 503, che attiva il meccanismo di ripetizione dell'operazione nella logica del routing in uscita di Lync Server. Il sistema pertanto tenterà di trovare un altro gateway per eseguire la chiamata. Per gestire questa situazione, è possibile creare una regola di conversione per mappare la combinazione di codice di causa ISUP 34 e di codice di risposta SIP 486 a un codice di risposta SIP 503.

Remove-CsSipResponseCodeTranslationRule consente di eliminare tutte le regole di conversione precedentemente configurate per l'utilizzo nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsSipResponseCodeTranslationRule i 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-CsSipResponseCodeTranslationRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per la regola di conversione da eliminare. L'identità di una regola di conversione è composta da due parti: l'ambito in cui è stata configurata la regola e il nome assegnato alla regola al momento della creazione. Ad esempio, una regola di conversione denominata Rule404 che sia stata creata nell'ambito globale avrebbe un'identità analoga alla seguente: global/Rule404.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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.SipResponseCodeTranslationRule#Decorated. Remove-CsSipResponseCodeTranslationRule accetta le istanze da pipeline dell'oggetto regola di conversione dei codici di risposta SIP.

Tipi restituiti

Remove-CsSipResponseCodeTranslationRule non restituisce alcun oggetto o valore. Il cmdlet piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

Esempio

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

Remove-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404"

Il comando mostrato nell'esempio 1 elimina una regola di conversione del codice di risposta singola: la regola con identità PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "service:PstnGateway:192.168.0.240/*" | Remove-CsSipResponseTranslationCode

Nell'esempio 2, vengono rimosse tutte le regole di conversione del codice di risposta dal gateway PSTN 192.168.0.240. A tale scopo, il comando chiama innanzitutto Get-CsSipResponseCodeTranslationRule insieme al parametro Filter. Il valore di filtro "service:PstnGateway:192.168.0.240/*" limita i dati restituiti alle regole con valore Identity che inizia con il valore stringa "service:PstnGateway:192.168.0.240/". La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsSipResponseTranslationCode, che elimina ogni regola della raccolta.

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

Get-CsSipResponseCodeTranslationRule | Where-Object {$_.ReceivedISUPCauseValue -eq -1} | Remove-CsSipResponseTranslationCode

Il comando precedente elimina tutte le regole di conversione dei codici di risposta in cui non è stato configurato alcun valore per la proprietà ReceivedISUPCauseValue. A tale scopo, il comando chiama innanzitutto Get-CsSipResponseCodeTranslationRule senza parametri per restituire una raccolta di tutte le regole di conversione dei codici di risposta attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le regole con proprietà ReceivedISUPCauseValue uguale a -1.

A questo punto, la raccolta filtrata viene inviata tramite pipe a Remove-CsSipResponseTranslationCode, che elimina ogni regola della raccolta.