Set-CsMediationServer
Ultima modifica dell'argomento: 2012-03-26
Consente di modificare le proprietà di uno o più server Mediation Server. I server Mediation Server vengono utilizzati per instradare il traffico tra l'infrastruttura interna di VoIP aziendale e un gateway PSTN (Public Switched Telephone Network) o un SIP trunk.
Sintassi
Set-CsMediationServer [-Identity <XdsGlobalRelativeIdentity>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-Registrar <String>] [-SipClientTcpPort <UInt16>] [-SipClientTlsPort <UInt16>] [-SipServerPort <UInt16>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
I server Mediation Server fungono da collegamento tra la configurazione VoIP aziendale interna e un gateway PSTN, IP-PBX o trunk SIP. In questo modo, gli utenti di VoIP aziendale che utilizzano dispositivi VoIP possono comunicare con persone che utilizzano cellulari o telefoni con linea terrestre standard. Il cmdlet Set-CsMediationServer consente di modificare un server Mediation Server esistente. In particolare, è possibile modificare le porte utilizzate per comunicare con i dispositivi client, i Front End Server e i gateway peer. Se necessario, è possibile utilizzare il cmdlet Set-CsMediationServer anche per associare un server Mediation Server a un nuovo server di registrazione o Edge Server.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsMediationServer 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-CsMediationServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Percorso di installazione del Mediation Server da modificare. Ad esempio: -Identity "MediationServer:atl-cs-001.litwareinc.com". Si noti che è possibile non utilizzare il prefisso "MediationServer:" quando si specifica un Mediation Server. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
AudioPortCount |
Facoltativo |
Numero intero |
Il numero totale di porte allocate per l'invio e la ricezione di traffico audio. Il numero di porte effettive da aprire inizia con il valore configurato per AudioPortStart e continua con il numero di porte specificato per AudioPortCount. Ad esempio, se AudioPortStart è impostato su 60000 e AudioPortCount è impostato su 100, per il traffico audio verranno utilizzate le porte da 600000 a 60099 incluse. Sono necessarie minimo sette porte multimediali per l'inoltro di una singola chiamata audio: Due porte gateway. Una porta è necessaria per il traffico con protocollo RTP (real-time transport protocol) e una è necessaria per il traffico con protocollo RTPC (real-time transport control protocol). Due porte di trasmissione UDP (User Datagram Protocol), una per il traffico RTP e una per il traffico RTCP. Una porta di trasmissione TCP (Transmission Control Protocol). Una singola porta di trasmissione TCP può gestire sia il traffico RTP che RTCP. Due porte locali per l'interfaccia di rete, una per il traffico RTP e una per il traffico RTCP |
AudioPortStart |
Facoltativo |
Numero intero |
La prima di una serie di porte allocate per l'invio e la ricezione di traffico audio. Ad esempio: –AudioPortStart 60000. |
EdgeServer |
Facoltativo |
Stringa |
Identità del servizio di Edge Server da associare con Mediation Server. Ad esempio: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
Registrar |
Facoltativo |
Stringa |
Identità del servizio di Registrar da associare con Mediation Server. Ad esempio: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
SipClientTcpPort |
Facoltativo |
Numero intero |
Porta di attesa utilizzata per la comunicazione con il gateway peer utilizzando TCP. Per impostazione predefinita, non viene definita nessuna porta TCP; tuttavia una porta TCP con numero di porta 5068 verrà creata automaticamente durante la creazione del gateway PSTN. Se si modifica SipClientTcpPort sarà necessario riavviare il servizio Mediation Server prima che la nuova porta venga realmente utilizzata. |
SipClientTlsPort |
Facoltativo |
Numero intero |
Porta di attesa utilizzata per comunicare con i gateway peer utilizzando il protocollo TLS (Transport Layer Security). Per impostazione predefinita, SipClientTlsPort viene configurato per utilizzare la porta 5067. Se si modifica SipClientTlsPort sarà necessario riavviare il servizio Mediation Server prima che la nuova porta venga realmente utilizzata. |
SipServerPort |
Facoltativo |
Numero intero |
Porta di attesa utilizzata per comunicare con Front End Server. Per impostazione predefinita, il parametro SipServerPort viene configurato per utilizzare la porta 5070. Se si modifica il valore di SipServerPort, sarà necessario riavviare il servizio Mediation Server prima che la nuova porta venga utilizzata. |
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
Nessuno. Set-CsMediationServer non accetta input tramite pipeline.
Tipi restituiti
Set-CsMediationServer non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di modificare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayMediationServer.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -SipClientTcpPort 5072
Il comando riportato nell'Esempio 1 consente di impostare la porta TCP del client SIP su 5072 per il server Mediation Server MediationServer:atl-cs-001.litwareinc.com. Dopo aver modificato la porta sarà necessario riavviare Mediation service di Lync Server.
-------------------------- Esempio 2 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -AudioPortStart 60000 -AudioPortCount 1000
Il comando precedente consente di configurare le impostazioni delle porte audio per il server Mediation Server MediationServer:atl-cs-001.litwareinc.com. In questo esempio, la porta audio iniziale è impostata su 60000 e il numero totale di porte allocate per l'audio è 1000