Condividi tramite

  • Articolo

Set-CsSipResponseCodeTranslationRule

 

Ultima modifica dell'argomento: 2012-03-27

Consente di modificare una regola di conversione dei codici di risposta SIP. Queste regole consentono agli amministratori di convertire i codici di risposta SIP con valori tra 400 e 699 in valori utilizzati da Microsoft Lync Server 2010.

Sintassi

Set-CsSipResponseCodeTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsSipResponseCodeTranslationRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Trunking SIP fornisce un mezzo per collegare una rete VoIP (Voice over Internet Protocol), ad esempio VoIP aziendale, a una rete PSTN (Public Switched Telephone Network). In Lync Server 2010, Mediation Server utilizza trunking peer per interagire con la rete PSTN. Quando una chiamata in uscita su una rete PSTN termina con errore, viene generato automaticamente un codice di causa ISUP (ISDN User Part). Ad esempio, un gateway PSTN potrebbe inviare un codice di causa 34 per indicare che non sono disponibili circuiti o canali per completare la chiamata. Quando un trunking peer Mediation Server riceve quel codice di causa ISUP, lo converte in un codice di risposta SIP che viene poi inviato al Mediation Server stesso. A sua volta, Lync Server utilizza questi codici di risposta per prendere le proprie decisioni di instradamento in uscita. Ad esempio, ad un gateway che non funziona correttamente potrebbe venire assegnato automaticamente uno stato di bassa priorità per limitare l'uso di quel gateway e aumentare le possibilità di completare correttamente una chiamata.

Tuttavia, non tutti i gateway utilizzano il mapping da codici di causa ISUP a codici di risposta SIP consigliato utilizzato da Lync Server. Per questi gateway, gli amministratori possono utilizzare i cmdlet CsSipResponseCodeTranslationRule per convertire i codici di risposta SIP del gateway (in combinazione con il codice di causa ISUP, se disponibile) in un codice di risposta SIP utilizzato da Lync Server. Ad esempio, un gateway potrebbe convertire un codice di causa ISUP 34 ("Nessun circuito/canale disponibile") in un codice di risposta SIP 486 ("Non disponibile qui"). Basandosi su un codice di riposta 486, la logica di instradamento in uscita di Lync Server non cercherà un altro gateway per completare la chiamata.

Per Lync Server, tuttavia, quel codice di risposta SIP 486 potrebbe essere convertito in un codice di risposta SIP 503. Il codice di risposta 503 avvia il meccanismo di riprova nella logica di instradamento in uscita di Lync Server; ciò significa che il sistema cercherà un altro gateway per completare la chiamata. Per gestire questa situazione è possibile creare una regola di conversione che converta un codice di causa ISUP 34 e un codice di risposta SIP 486 in un codice di risposta SIP 503.

Il cmdlet Set-CsSipResponseCodeTranslationRule consente di modificare le regole di conversione precedentemente configurate per l'utilizzo nella propria organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsSipResponseCodeTranslationRule 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 "Set-CsSipResponseCodeTranslationRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

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

Instance

Facoltativo

Numero intero

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

TranslatedResponseCode

Obbligatorio

Numero intero

Il valore del codice di risposta SIP nel quale deve essere convertito il codice ReceivedResponseCode e/o ReceivedISUPCauseCode. I codici di risposta convertiti possono essere un valore intero compreso tra 400 e 699, inclusi.

Priority

Numero intero

Priorità relativa della regola di conversione. Le regole vengono elaborate in ordine di priorità; la prima regola elaborata è quella con priorità 0, la seconda regola elaborata è quella con priorità 1 e così via.

ReceivedISUPCauseValue

Facoltativo

Numero intero

Il valore del codice ISDN User Part (ISUP) che occorre sia presente nel messaggio di risposta SIP utilizzato da gateway, quando si risponde a un messaggio INVITE. Il valore -1 indica che verrà utilizzato solo il codice di risposta SIP per l'esecuzione della regola di conversione; il codice di causa ISUP verrà ignorato.

ReceivedResponseCode

Facoltativo

Numero intero

Il valore del codice di risposta SIP utilizzato da un gateway per la risposta a un messaggio INVITE. Un codice di risposta può essere un valore intero compreso tra 400 e 699, inclusi. Sebbene il cmdlet accetti i valori interi minori di 400, questi valori non sono riconosciuti come risposte finali. Di conseguenza, la regola di conversione non verrà mai utilizzata. Il valore 0 significa che verrà utilizzato solo il codice di risposta ISUP per l'esecuzione della regola di conversione; il codice di causa ISUP verrà ignorato.

Force

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

Parametro opzionale

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

Confirm

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. Set-CsSipResponseCodeTranslationRule accetta le istanze dell'oggetto codice risposta SIP inviate tramite pipeline.

Tipi restituiti

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

Esempio

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedISUPCauseValue 477

Il comando riportato nell'Esempio 1 consente di modificare la proprietà ReceivedISUPCauseValue della regola di conversione con Identity PstnGateway:192.168.0.240/Rule404.

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -Priority 0

Nell'Esempio 2, la regola di conversione con Identity PstnGateway:192.168.0.240/Rule404 ha la priorità più alta, vale a dire che questa regola verrà elaborata per prima. Infatti, la regola ha la priorità (Priority) impostata su 0.

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

Get-CsSipResponseCodeTranslationRule | Set-CsSipResponseCodeTranslationRule -ReceivedISUPCauseValue -1

Nell'Esempio 3, viene illustrato come impostare su -1 la proprietà ReceivedISUPCauseValue di tutte le regole di conversione configurate per l'utilizzo nella propria organizzazione; in tal modo, il codice di causa ISUP viene ignorato durante la conversione delle regole. Per ottenere questo risultato, il comando utilizza prima Get-CsSipResponseCodeTranslationRule senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le regole di conversione dei codici di risposta SIP attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Set-CsSipResponseCodeTranslationRule che modifica la proprietà ReceivedISUPCauseValue per ciascun elemento nella raccolta.