Set-CsMediationServer
Dernière rubrique modifiée : 2012-03-26
Vous permet de modifier les propriétés d’un ou de plusieurs serveurs de médiation. Les serveurs de médiation sont utilisés pour acheminer le trafic entre votre infrastructure Enterprise Voice interne et une passerelle de réseau téléphonique commuté (RTC) ou un tronçon SIP.
Syntaxe
Set-CsMediationServer [-Identity <XdsGlobalRelativeIdentity>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-Registrar <String>] [-SipClientTcpPort <UInt16>] [-SipClientTlsPort <UInt16>] [-SipServerPort <UInt16>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les serveurs de médiation servent de pont entre votre configuration Enterprise Voice interne et une passerelle RTC, un système IP-PBX ou un tronçon SIP. En retour, cela permet aux utilisateurs d’Enterprise Voice (qui utilisent des périphériques VoIP (Voice over IP)) de communiquer avec des utilisateurs de téléphones mobiles ou fixes standard. La cmdlet Set-CsMediationServer permet de modifier un serveur de médiation existant. Vous pouvez notamment modifier les ports utilisés pour communiquer avec des périphériques clients, des serveurs frontaux et des pairs passerelles. Si nécessaire, vous pouvez également utiliser la cmdlet Set-CsMediationServer pour associer un serveur de médiation à un nouveau serveur d’inscriptions ou un nouveau serveur Edge.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsMediationServer : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsMediationServer"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Emplacement de service du serveur de médiation à modifier. Par exemple : -Identity « MediationServer:atl-cs-001.litwareinc.com ». Notez que vous ne pouvez supprimer le préfixe « MediationServer: » pour spécifier un serveur de médiation. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
AudioPortCount |
Facultatif |
Entier |
Nombre total de ports alloués à l’envoi et la réception du trafic audio. Le nombre réel de ports à ouvrir commence à la valeur configurée pour AudioPortStart et continue jusqu’au nombre de ports spécifiés pour AudioPortCount. Ainsi, si AudioPortStart est défini sur 60000 et qu’AudioPortCount est défini sur 100, alors les ports 60000 à 60099 seront utilisés pour le trafic audio. Un minimum de sept ports multimédia sont nécessaire pour relayer un seul appel audio : Deux ports de passerelle. Un port est nécessaire pour le trafic RTP (Real-time Transport Protocol) et un autre pour le trafic RTCP (Real-time Transport Control Protocol). Deux ports de relais UDP (User Datagram Protocol), un pour le trafic RTP et un pour le trafic RTCP. Un port de relais TCP (Transmission Control Protocol). Un seul port de relais TCP peut gérer le trafic RTP et RTCP. Deux ports locaux par interface réseau, un pour le trafic RTP et un pour le trafic RTCP |
AudioPortStart |
Facultatif |
Entier |
Premier port de la plage de ports allouée à l’envoi et la réception du trafic audio. Par exemple : –AudioPortStart 60000. |
EdgeServer |
Facultatif |
Chaîne |
Identité de service du serveur Edge à associer au serveur de médiation. Par exemple : -EdgeServer « EdgeServer:atl-edge-001.litwareinc.com ». |
Registrar |
Facultatif |
Chaîne |
Identité de service du serveur d'inscriptions à associer au serveur de médiation. Par exemple : -Registrar « Registrar:atl-cs-001.litwareinc.com ». |
SipClientTcpPort |
Facultatif |
Entier |
Port d'écoute utilisé pour communiquer avec les pairs de passerelle à l'aide du protocole TCP. Par défaut, aucun port TCP n'est défini ; toutefois, un port TCP avec le numéro de port 5068 sera automatiquement créé lorsqu'une passerelle PSTN sera créée. Si vous changez le SipClientTcpPort, vous devrez redémarrer le service de serveur de médiation avant que le nouveau port puisse véritablement être utilisé. |
SipClientTlsPort |
Facultatif |
Entier |
Port d'écoute utilisé pour communiquer avec les pairs de passerelle à l'aide du protocole TLS (Transport Layer Security). Par défaut, SipClientTlsPort est configuré pour utiliser le port 5067. Si vous modifiez le SipClientTlsPort, vous devrez redémarrer le service de serveur de médiation avant que le nouveau port puisse véritablement être utilisé. |
SipServerPort |
Facultatif |
Entier |
Port d’écoute utilisé pour communiquer avec serveurs frontaux. Par défaut, SipServerPort est configuré pour utiliser le port 5070. Si vous modifiez le SipServerPort, vous devrez redémarrer le service serveur de médiation avant que le nouveau port puisse véritablement être utilisé. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Set-CsMediationServer n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsMediationServer ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet modifie des instances existantes de l’objet Microsoft.Rtc.Management.Xds.DisplayMediationServer.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -SipClientTcpPort 5072
La commande illustrée dans l’exemple 1 définit le port TCP de la passerelle SIP sur 5072 pour le serveur de médiation MediationServer:atl-cs-001.litwareinc.com. Après avoir modifié le port, vous devrez redémarrer le service de médiation Lync Server.
-------------------------- Exemple 2 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -AudioPortStart 60000 -AudioPortCount 1000
La commande précédente configure les paramètres du port audio du serveur de médiation MediationServer:atl-cs-001.litwareinc.com. Dans cet exemple, le port audio initial est défini sur 60000 et le nombre total de ports alloués à l’audio est 1000.