Condividi tramite

  • Articolo

New-CsTrunkConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Crea una nuova configurazione trunk che definisce le impostazioni per un'entità peer trunk quale un gateway PSTN, IP-PBX o SBC (Session Border Controller) nel provider di servizi.

Sintassi

New-CsTrunkConfiguration -Identity <XdsIdentity> [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Utilizzare questo cmdlet per creare una nuova configurazione di trunk applicabile alle entità del gateway PSTN. Ogni configurazione contiene impostazioni specifiche per un'entità peer trunk quale un gateway PSTN, IP-PBX o SBC nel provider di servizi. Tali impostazioni consentono di configurare vari aspetti, ad esempio se abilitare o meno il bypass multimediale in questo trunk, se i pacchetti RTCP devono essere inviati o meno in determinate condizioni e se richiedere o meno la crittografia SRTP (Secure Real-Time Protocol).

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet New-CsTrunkConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco che include l'ambito della configurazione trunk. Le configurazioni trunk possono essere create per l'ambito del sito, oppure per l'ambito del servizio nel caso di un gateway PSTN. (Una configurazione globale esiste per impostazione predefinita e non è possibile rimuoverla o ricrearla). Ad esempio, site:Redmond (per il sito) o PstnGateway:Redmond.litwareinc.com (per il servizio).

ConcentratedTopology

Facoltativo

Booleano

Il valore di questo parametro determina se esiste un punto di terminazione multimediale noto. Un esempio di punto di terminazione multimediale noto può essere costituito da un gateway PSTN in cui la terminazione dei supporti ha lo stesso IP della terminazione dei segnali. Impostare questo valore su False se il trunk non dispone di un punto di terminazione multimediale noto.

Valore predefinito: True

Description

Facoltativo

Stringa

Stringa che descrive lo scopo della configurazione trunk.

EnableBypass

Facoltativo

Booleano

Il valore di questo parametro determina se il bypass multimediale è abilitato per questo trunk. L'impostazione di questo valore su True consente di abilitare il bypass. Affinché il bypass multimediale funzioni correttamente, è necessario che i gateway PSTN, i controller SBC e i sistemi PBX supportino determinate funzionalità, tra cui:

- La possibilità di ricevere risposte instradate a un invito.

- I client Microsoft Lync Server 2010 e i punti di terminazione multimediale devono essere in grado di comunicare direttamente senza l'intermediazione di Mediation Server.

- La subnet del gateway deve essere definita nello stesso luogo della subnet del client oppure, se in luoghi diversi, è necessario che i siti non siano separati da collegamenti WAN con larghezza di banda limitata.

Il bypass multimediale può essere abilitato solo nei seguenti casi:

- Il parametro ConcentratedTopology è impostato su True

- Il parametro EnableReferSupport è impostato su False mentre RTCPActiveCalls e RTCPCallsOnHold sono impostati su False oppure EnableReferSupport è impostato su True

Se EnableBypass è True e EnableReferSupport è False, le chiamate di bypass che vengono successivamente trasferite diventeranno non di bypass.

Affinché il bypass multimediale funzioni per un determinato trunk, è necessario che venga abilitato globalmente oltre che per il trunk in questione. Utilizzare il cmdlet New-CsNetworkMediaBypassConfiguration per abilitare il bypass multimediale globalmente.

Valore predefinito: False

EnableMobileTrunkSupport

Facoltativo

Booleano

Specifica se il provider di servizi è un operatore di telefonia mobile.

Valore predefinito: False

EnablePIDFLOSupport

Facoltativo

Booleano

Definisce se inoltrare le chiamate di emergenza con Presence Information Data Format Location Object (PIDF-LO) tramite il gateway definito. Impostare questo parametro su True se le chiamate di emergenza devono essere instradate a un provider di servizi di emergenza certificato (la posizione verrà trasmessa con la chiamata).

Valore predefinito: False

EnableReferSupport

Facoltativo

Booleano

Specifica se questo trunk supporta la ricezione di richieste Refer da Mediation Server.

Il bypass multimediale può essere abilitato solo nei seguenti casi:

- Il parametro ConcentratedTopology è impostato su True

- Il parametro EnableReferSupport è impostato su False mentre RTCPActiveCalls e RTCPCallsOnHold sono impostati su False oppure EnableReferSupport è impostato su True

Se EnableBypass è True e EnableReferSupport è False, le chiamate di bypass che vengono successivamente trasferite diventeranno non di bypass.

Valore predefinito: True

EnableSessionTimer

Facoltativo

Booleano

Specifica se il timer sessione è abilitato. I timer sessione consentono di determinare se una determinata sessione è ancora attiva.

Anche se questo parametro è impostato su False, i timer di sessione possono essere applicabili se per la connessione remota è abilitato un timer di sessione. In tal caso Mediation Server risponde ai probe del timer di sessione dall'entità remota.

Valore predefinito: False

EnableSignalBoost

Facoltativo

Booleano

Quando questo parametro è impostato su True, il gateway PSTN, IP-PBX o SBC nel provider di servizi incrementano il volume dell'audio nei flussi vocali inviati a Mediation Server o ai clienti Microsoft Lync Server 2010. Se questo valore è impostato su False, l'audio verrà aumentato in Mediation Server (per le chiamate non di bypass) o nei client Lync Server 2010 (per le chiamate di bypass).

Valore predefinito: False

MaxEarlyDialogs

Facoltativo

Int64

Il numero massimo di risposte instradate che un gateway PSTN, IP-PBX o SBC nel provider di servizi può ricevere per un invito inviato a Mediation Server.

Valore predefinito: 20

OutboundTranslationRulesList

Facoltativo

PSListModifier

Raccolta di regole di conversione dei numeri di telefono che si applicano alle chiamate gestite mediante il routing in uscita (chiamate instradate a destinazioni PBX o PSTN).

Sebbene l'elenco e le regole possano essere creati direttamente con questo cmdlet, è consigliabile creare le regole di conversione in uscita mediante il cmdlet New-CsOutboundTranslationRule, che crea la regola e la assegna alla configurazione trunk con ambito corrispondente.

RemovePlusFromUri

Facoltativo

Booleano

Se il parametro viene impostato su True, Mediation Server rimuoverà i segni più (+) iniziali dagli URI prima di inviarli al provider di servizi.

Valore predefinito: False

RTCPActiveCalls

Facoltativo

Booleano

Questo parametro determina se i pacchetti RTCP vengono inviati dal gateway PSTN, da IP-PBX o da SBC al provider di servizi per le chiamate attive. Una chiamata attiva in questo contesto è una chiamata in cui il flusso dei supporti è consentito almeno in una direzione. Se RTCPActiveCalls è impostato su True, Mediation Server o il client Lync Server possono terminare una chiamata se non riceve i pacchetti RTCP per un periodo che superi 30 secondi.

Se si disabilitano i controlli per i supporti RTCP ricevuti per le chiamate attive negli elementi di Lync Server, si rimuove un importante strumento per rilevare un peer rimosso, pertanto questa operazione deve essere eseguita solo se necessaria.

Valore predefinito: True

RTCPCallsOnHold

Facoltativo

Booleano

Questo parametro determina se i pacchetti RTCP continuano a essere inviati attraverso il trunk per le chiamate messe in attesa e non è previsto il flusso di pacchetti di supporti in alcuna direzione. Se la musica di attesa è abilitata nel client Lync Server o nel trunk, la chiamata verrà considerata attiva e questa proprietà verrà ignorata. In queste circostanze utilizzare il parametro RTCPActiveCalls.

Se si disabilitano i controlli per i supporti RTCP ricevuti per le chiamate attive negli elementi di Lync Server, si rimuove un importante strumento per rilevare un peer rimosso, pertanto questa operazione deve essere eseguita solo se necessaria.

Valore predefinito: True

SipResponseCodeTranslationRulesList

Facoltativo

PSListModifier

Un elenco di regole di conversione del codice di risposta SIP applicate ai codici di risposta ricevuti da un gateway PSTN, da IP-PBX o da SBC nel provider di servizi. Queste regole consentono all'amministratore di mappare i codici di risposta SIP a valori compresi tra 400 e 699 ricevuti su un trunk a nuovi valori più coerenti con Lync Server.

È possibile creare questo elenco e le regole corrispondenti direttamente tramite questo cmdlet. È tuttavia consigliabile creare le regole di conversione del codice di risposta SIP mediante la chiamata del cmdlet New-CsSipResponseCodeTranslationRule. Tale cmdlet crea la regola e la assegna alla configurazione del trunk con l'ambito corrispondente.

SRTPMode

Facoltativo

SRTPMode

Il valore di questo parametro specifica il livello di supporto del protocollo SRTP per la protezione del traffico multimediale tra Mediation Server e il gateway PSTN, il sistema IP-PBX o il servizio SBC nel provider dei servizi. Nel caso del bypass multimediale, questo valore deve essere compatibile con l'impostazione di EncryptionLevel nella configurazione degli elementi multimediali. La configurazione degli elementi multimediali viene definita utilizzando i cmdlet New-CsMediaConfiguration e Set-CsMediaConfiguration.

Valori validi:

- Obbligatorio: è necessario utilizzare la crittografia SRTP.

- Facoltativo: SRTP verrà utilizzato se supportato dal gateway.

- Non supportato: la crittografia SRTP non è supportata, pertanto non verrà utilizzata.

Si noti che SRTPMode viene utilizzato solo se il gateway è configurato per l'uso di TLS (Transport Layer Security). Se il gateway è configurato con il protocollo TCP (Transmission Control Protocol) per il trasporto, SRTPMode viene impostato internamente su NotSupported.

Valore predefinito: Obbligatorio

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Crea un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Esempio

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

New-CsTrunkConfiguration -Identity site:Redmond

Con questo esempio viene creata una nuova configurazione trunk con identità site:Redmond. Le restanti proprietà per questa nuova configurazione verranno popolate con valori predefiniti.

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

New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True

Con questo esempio viene creata una nuova configurazione trunk con identità site:Redmond e viene abilitato il bypass multimediale. Il bypass multimediale viene abilitato assegnando il valore $True al parametro EnableBypass. Le restanti proprietà per questa nuova configurazione verranno popolate con valori predefiniti.

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

New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'

Con questo esempio viene creata una nuova configurazione trunk con identità site:Redmond, quindi viene assegnata una nuova conversione in uscita a tale trunk. Nella prima riga dell'esempio viene chiamato New-CsTrunkConfiguration per creare la nuova configurazione trunk con impostazioni predefinite. Nella seconda linea viene chiamato il cmdlet New-CsOutboundTranslationRule. Si noti il valore assegnato all'identità: site:Redmond/OTR1. La prima parte dell'identità (site:Redmond) definisce l'ambito a cui viene applicata la regola. Tale ambito corrisponde all'identità della nuova configurazione trunk, pertanto questa regola verrà applicata automaticamente a tale configurazione. L'ambito è seguito da una barra (/) e da una stringa, che corrisponde a un nome univoco per questa regola (possono esistere più regole per ogni ambito). Vengono quindi passati valori ai parametri Pattern e Translation per definire questa regola.