Condividi tramite

  • Articolo

Get-CsSipResponseCodeTranslationRule

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle regole 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

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

Get-CsSipResponseCodeTranslationRule [-Filter <String>] [-LocalStore <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 2010. 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 Get-CsSipResponseCodeTranslationRule consente di recuperare informazioni relative a tutte le regole di conversione configurate per l'utilizzo nella propria organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsSipResponseCodeTranslationRule può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsSipResponseCodeTranslationRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco della regola di conversione. 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.

Oltre che nell'ambito globale, le regole di conversione possono anche essere create a livello di sito o di servizio (sebbene solo per il servizio PstnGateway).

Per ottenere tutte le regole di conversione create per un determinato sito o servizio, basta specificare l'identità del sito o servizio in questione. Ad esempio:

-Identity "site:Redmond."

Se questo parametro viene omesso, il cmdlet Get-CsSipResponseCodeTranslationRule restituisce una raccolta di tutti i codici di conversione delle risposte SIP.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare la regola o le regole di conversione da ottenere. Ad esempio, la seguente sintassi restituisce tutte le regole di conversione la cui identità contiene la stringa "404":

-Filter "*404*"

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati delle regole di conversione del codice di risposta SIP dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsSipResponseCodeTranslationRule non accetta input tramite pipeline.

Tipi restituiti

Get-CsSipResponseCodeTranslationRule restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Esempio

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

Get-CsSipResponseCodeTranslationRule

Il comando riportato nell'Esempio 1 restituisce una raccolta di tutte le regole di conversione dei codici di risposta configurati per l'utilizzo nella propria organizzazione. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsSipResponseCodeTranslationRule senza alcun parametro aggiuntivo.

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

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

Il comando precedente restituisce una singola regola di conversione dei codici di risposta: la regola con identità Identity PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "site:*"

nell'esempio 3, il parametro Filter viene utilizzato per limitare la quantità di dati restituiti a tutte le regole di conversione dei codici di risposta configurate nell'ambito del sito. Il valore del filtro "site:*" restituisce solo i dati relativi a quelle regole la cui identità inizia con la stringa "site:".

-------------------------- Esempio 4 --------------------------

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

Il comando riportato nell'Esempio 4 restituisce una raccolta tutte le regole di conversione dei codici di risposta nelle quali non è stato configurato alcun valore per la proprietà ReceivedISUPCauseValue. 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 attualmente in uso. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle regole in cui la proprietà ReceivedISUPCauseValue è uguale a (-eq) -1.