Set-CsTrunkConfiguration
Ultima modifica dell'argomento: 2012-03-25
Modifica una configurazione trunk esistente che descrive le impostazioni di un'entità trunking peer, ad esempio un gateway PSTN (Public Switched Telephone Network), un sistema IP-PBX (Public Branch Exchange) o un servizio SBC (Session Border Controller) nel provider di servizi.
Sintassi
Set-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>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-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>] [-Instance <PSObject>] [-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 modificare una configurazione di trunking applicabile a entità gateway PSTN. Ogni configurazione contiene impostazioni specifiche di un'entità trunking peer, ad esempio un gateway PSTN, un sistema IP-PBX o un servizio SBC nel provider di servizi. Tali impostazioni consentono di configurare diversi aspetti, ad esempio se abilitare o meno il bypass degli elementi multimediali in questo trunk, se inviare o meno i pacchetti RTCP (Real-Time Control Protocol) in determinate condizioni e se richiedere o meno la crittografia SRTP (Secure Real-Time Protocol).
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsTrunkConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire 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-CsTrunkConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Identificatore univoco che include l'ambito della configurazione trunk. Le configurazioni trunk possono esistere nell'ambito globale o del sito oppure nell'ambito del servizio nel caso di un servizio gateway PSTN, ad esempio site:Redmond per il sito o PstnGateway:Redmond.litwareinc.com per il servizio. |
Instance |
Facoltativo |
TrunkConfiguration |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Questo parametro richiede un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration, che può essere recuperato chiamando il cmdlet Get-CsTrunkConfiguration. |
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 degli elementi multimediali 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. Impostare questo valore su True per abilitare il bypass. Per il corretto funzionamento del bypass multimediale, devono essere supportate alcune funzionalità da parte dei gateway PSTN, dei servizi SBC e dei sistemi PBX, tra cui: - La possibilità di ricevere risposte instradate a un invito. - I client Lync Server 2010 e il punto 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 degli elementi multimediali può essere abilitato solo se vengono soddisfatte le seguenti condizioni: - Il parametro ConcentratedTopology è impostato su True - Il parametro EnableReferSupport è impostato su False e RTCPActiveCalls e RTCPCallsOnHold sono impostati su False oppure EnableReferSupport è impostato su True Se EnableBypass è impostato su True ed EnableReferSupport è impostato su False, le chiamate di bypass che verranno trasferite successivamente diventeranno di non bypass. Affinché il bypass multimediale funzioni per un determinato trunk, è necessario che venga abilitato sia globalmente che per il trunk in questione. Per abilitare il bypass multimediale globalmente, utilizzare il cmdlet New-CsNetworkMediaBypassConfiguration. Valore predefinito: False |
EnableMobileTrunkSupport |
Facoltativo |
Booleano |
Specifica se il provider di servizi è un operatore di telefonia mobile. Valore predefinito: False |
EnablePIDFLOSupport |
Facoltativo |
Booleano |
Specifica se instradare le chiamate di emergenza con PIDF-LO (Presence Information Data Format Location Object) attraverso il gateway definito. Impostare il 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 degli elementi multimediali può essere abilitato solo se vengono soddisfatte le seguenti condizioni: - Il parametro ConcentratedTopology è impostato su True - Il parametro EnableReferSupport è impostato su False e RTCPActiveCalls e RTCPCallsOnHold sono impostati su False oppure EnableReferSupport è impostato su True Se EnableBypass è impostato su True ed EnableReferSupport è impostato su False, le chiamate di bypass che verranno trasferite successivamente diventeranno di non 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, è possibile che i timer sessione siano applicabili se sono abilitati nella connessione remota. In questo caso, Mediation Server risponderà alle indagini dei timer sessione dall'entità remota. Valore predefinito: False |
EnableSignalBoost |
Facoltativo |
Booleano |
Quando questo parametro è impostato su True, il gateway PSTN, il sistema IP-PBX o il servizio SBC nel provider di servizi incrementa il volume audio in flussi vocali che vengono inviati ai client Mediation Server o Microsoft Lync Server 2010. Se il valore è impostato su False, il volume audio verrà aumentato in Mediation Server (per chiamate non di bypass) o nei client Lync Server 2010 (per chiamate di bypass). Valore predefinito: False |
MaxEarlyDialogs |
Facoltativo |
Int64 |
Numero massimo di risposte instradate che possono essere ricevute da un gateway PSTN, un sistema IP-PBX o un servizio SBC nel provider di servizi 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 modificati direttamente tramite questo cmdlet, è consigliabile modificare le regole di conversione delle chiamate in uscita mediante il cmdlet Set-CsOutboundTranslationRule. Tramite Set-CsOutboundTranslationRule viene modificata la regola e le modifiche vengono estese automaticamente alla configurazione trunk. Per modificare la configurazione trunk tramite l'aggiunta di una nuova regola di conversione delle chiamate in uscita, chiamare il cmdlet New-CsOutboundTranslationRule. La nuova regola verrà aggiunta alla configurazione trunk con l'ambito corrispondente. |
RemovePlusFromUri |
Facoltativo |
Booleano |
Se il parametro viene impostato su True, Mediation Server rimuoverà i segni più (+) iniziali dagli URI (Uniform Resource Identifier) prima di inviarli al provider di servizi. Valore predefinito: False |
RTCPActiveCalls |
Facoltativo |
Booleano |
Questo parametro specifica se i pacchetti RTCP devono continuare a essere inviati dal gateway PSTN, dal sistema IP-PBX o dal servizio SBC nel provider di servizi per le chiamate attive. Una chiamata attiva in questo contesto indica una chiamata in cui è consentito il flusso degli elementi multimediali almeno in una direzione. Se il valore di RTCPActiveCalls è impostato su True, il client Mediation Server o Lync Server può terminare una chiamata qualora non riceva pacchetti RTCP per oltre 30 secondi. Con la disabilitazione dei controlli degli elementi multimediali RTCP ricevuti per le chiamate attive in elementi Lync Server viene rimossa un'importante protezione per l'individuazione di un peer rimosso. Questa operazione deve essere effettuata solo se necessario. Valore predefinito: True |
RTCPCallsOnHold |
Facoltativo |
Booleano |
Questo parametro specifica se i pacchetti RTCP devono continuare a essere inviati attraverso il trunk per le chiamate in attesa e se non deve essere previsto il flusso di pacchetti di elementi multimediali in alcuna direzione. Se è abilitato il comando di musica di attesa nel client Lync Server o nel trunk, la chiamata verrà considerata attiva e questa proprietà verrà ignorata. In questo caso utilizzare il parametro RTCPActiveCalls. Con la disabilitazione dei controlli degli elementi multimediali RTCP ricevuti per le chiamate attive in elementi Lync Server viene rimossa un'importante protezione per l'individuazione di un peer rimosso. Questa operazione deve essere effettuata solo se necessario. Valore predefinito: True |
SipResponseCodeTranslationRulesList |
Facoltativo |
PSListModifier |
Elenco di regole di conversione del codice di riposta SIP che si applicano ai codici di risposta ricevuti da un gateway PSTN, un sistema IP-PBX o un servizio SBC nel provider di servizi. Queste regole consentono all'amministratore di eseguire il mapping tra i codici di risposta SIP con valori compresi tra 400 e 699 ricevuti su un trunk e 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 consente di creare la regola e assegnarla alla configurazione 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 provider di servizi. - Non supportato: la crittografia SRTP non è supportata, pertanto non verrà utilizzata. Si noti che il parametro SRTPMode viene utilizzato esclusivamente se il gateway è configurato per l'utilizzo del protocollo TLS (Transport Layer Security). Se invece il gateway è configurato con il protocollo TCP (Transmission Control Protocol) per il trasporto, il parametro SRTPMode verrà 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. |
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.TrunkConfiguration. Accetta l'input da pipeline di oggetti configurazione trunk.
Tipi restituiti
Questo cmdlet non restituisce un valore, bensì modifica un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
Con questo esempio viene modificata una configurazione trunk con identità site:Redmond e viene abilitato il bypass degli elementi multimediali. Il bypass degli elementi multimediali viene abilitato assegnando il valore $True al parametro EnableBypass. Le proprietà rimanenti per questa configurazione manterranno i valori esistenti.
-------------------------- Esempio 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
In questo esempio viene modificata una regola di conversione delle chiamate in uscita per la configurazione trunk con identità site:Redmond. Si noti che per apportare la modifica non viene effettivamente chiamato il cmdlet Set-CsTrunkConfiguration. Le modifiche apportate tramite Set-CsOutboundTranslationRule verranno estese automaticamente alla configurazione trunk con identità corrispondente alla parte di ambito dell'identità della regola di conversione delle chiamate in uscita.
-------------------------- Esempio 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
Nell'esempio 3 viene impostato SRTPMode per tutte le configurazioni trunk definite su Facoltativo nell'ambito del sito. Nella prima parte del comando viene chiamato il cmdlet Get-CsTrunkConfiguration, che utilizza il parametro Filter per recuperare tutte le configurazioni trunk con valore Identity che inizia con site:, ovvero tutte le configurazioni trunk definite a livello di sito. La raccolta di configurazioni viene quindi inviata tramite pipe al cmdlet Set-CsTrunkConfiguration, che imposta la proprietà SRTPMode di ciascuna configurazione su Optional.
-------------------------- Esempio 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
In questo esempio viene modificata una configurazione trunk con identità site:Redmond per abilitare il supporto PIDF-LO. Per impostazione predefinita, il valore del parametro EnablePIDFLOSupport è False. In questo esempio, il valore viene impostato su True per consentire il supporto della posizione per le chiamate di emergenza. Per consentire l'invio delle informazioni sulla posizione al trunk da parte dell'applicazione di routing in uscita, è necessario impostare EnablePIDFLOSupport su True.