Set-CsEdgeServer
Dernière rubrique modifiée : 2012-03-26
Modifie les valeurs de propriété d’un ou plusieurs serveurs Edge. Les serveurs Edge fournissent la connectivité entre votre réseau interne et Internet.
Syntaxe
Set-CsEdgeServer [-Identity <XdsGlobalRelativeIdentity>] [-AccessEdgeClientSipPort <UInt16>] [-AccessEdgeExternalSipPort <Nullable>] [-AccessEdgeInternalSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomClientPort <Nullable>] [-DataPsomServerPort <UInt16>] [-Force <SwitchParameter>] [-MediaCommunicationPortCount <UInt16>] [-MediaCommunicationPortStart <UInt16>] [-MediaRelayAuthEdgePort <UInt16>] [-MediaRelayExternalTurnTcpPort <UInt16>] [-MediaRelayExternalTurnUdpPort <UInt16>] [-MediaRelayInternalTurnTcpPort <UInt16>] [-MediaRelayInternalTurnUdpPort <UInt16>] [-Registrar <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La connectivité avec le monde extérieur, c'est-à-dire Internet, est l'un des aspects important de Microsoft Lync Server 2010. Sans cette connectivité, les utilisateurs devraient se connecter au réseau interne afin d'accéder à Lync Server 2010. Il serait alors difficile pour les utilisateurs travaillant hors site d'utiliser le logiciel et cela empêcherait ceux qui n'ont pas de compte dans votre domaine de prendre part aux conférences. De même, sans connectivité avec l'extérieur de l'organisation, les utilisateurs ne pourraient pas échanger des messages instantanés avec des partenaires fédérés ou avec des personnes disposant de comptes sur un système de messagerie instantanée public, tel que Yahoo!, AOL ou MSN.
Les serveurs Edge fournissent la connectivité entre votre réseau interne et Internet. La cmdlet Set-CsEdgeServer vous permet de modifier les paramètres de configuration de vos serveurs Edge, tâche qui implique notamment de changer les numéros de port utilisés pour la transmission du trafic réseau.
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-CsEdgeServer : 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-CsEdgeServer"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Emplacement de service du serveur Edge à modifier. Par exemple : -Identity "EdgeServer:atl-edge-001.litwareinc.com". Veuillez noter que vous pouvez ne pas renseigner le préfixe "EdgeServer:" lorsque vous spécifiez un serveur de périphérie. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
AccessEdgeClientSipPort |
Facultatif |
Entier |
Port utilisé pour les communications SIP entre le serveur Edge et les périphériques clients. La valeur initiale est définie dans Générateur de topologies mais elle peut être modifiée en affectant une nouvelle valeur à ce paramètre. |
AccessEdgeExternalSipPort |
Facultatif |
Entier |
Port utilisé pour le trafic SIP externe. La valeur par défaut est 5061. |
AccessEdgeInternalSipPort |
Facultatif |
Entier |
Port utilisé pour le trafic SIP interne. La valeur par défaut est 5061. |
DataPsomClientPort |
Facultatif |
Entier |
Port utilisé pour les communications PSOM (Persistent Shared Object Model) entre le serveur Edge et les périphériques clients. La valeur initiale est définie dans Générateur de topologies mais elle peut être modifiée en affectant une nouvelle valeur à ce paramètre. |
DataPsomServerPort |
Facultatif |
Entier |
Port utilisé pour les communications PSOM entre le serveur Edge et d'autres serveurs. |
MediaCommunicationPortCount |
Facultatif |
Entier |
Nombre total de ports alloués aux communications multimédias sur le serveur Edge externe. La valeur par défaut est 10 000. |
MediaCommunicationPortStart |
Facultatif |
Entier |
Numéro de port de début sur le serveur Edge externe destiné aux communications multimédias. La valeur par défaut est 50000. |
MediaRelayAuthEdgePort |
Facultatif |
Entier |
Port utilisé pour l’authentification du relais multimédia. La valeur par défaut est 5062. |
MediaRelayExternalTurnTcpPort |
Facultatif |
Entier |
Port utilisé pour le trafic relais multimédia externe via le protocole TCP (Transmission Control Protocol). La valeur par défaut est 444 si votre serveur Edge a une seule adresse IP. S’il a plusieurs adresses IP, la valeur par défaut est 443. Ces valeurs sont définies initialement dans Générateur de topologies mais vous pouvez les modifier en affectant une nouvelle valeur à ce paramètre. |
MediaRelayExternalTurnUdpPort |
Facultatif |
Entier |
Port utilisé pour le trafic relais multimédia externe via UDP (User Datagram Protocol). La valeur par défaut est 3478. |
MediaRelayInternalTurnTcpPort |
Facultatif |
Entier |
Port utilisé pour le trafic relais multimédia interne via TCP (Transmission Control Protocol). La valeur par défaut est 443. |
MediaRelayInternalTurnUdpPort |
Facultatif |
Entier |
Port utilisé pour le trafic relais multimédia interne via UDP (User Datagram Protocol). La valeur par défaut est 3478. |
Registrar |
Facultatif |
Chaîne |
Emplacement de service du serveur d'inscriptions à associer au serveur Edge. Par exemple : -Registrar "Registrar:atl-cs-001.litwareinc.com". |
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 |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Set-CsEdgeServer n'accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsEdgeServer ne retourne ni objet, ni valeur. Au lieu de cela, la cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Management.Xds.DisplayEdgeServer.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
La commande présentée dans l'exemple 1 modifie les ports SIP interne et externe du serveur Edge « EdgeServer:atl-edge-001.litwareinc.com ».
-------------------------- Exemple 2 ------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
L’exemple 2 modifie les ports SIP interne et externe de tous les serveurs Edge situés sur le site Redmond. Pour ce faire, la commande utilise d'abord Get-CsService et le paramètre EdgeServer pour retourner une collection de tous les serveurs Edge actuellement utilisés dans l'organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les serveurs de périphériques du site Redmond, à savoir ceux pour lesquels la propriété SiteId est égale à site:Redmond. Une fois filtrée, cette collection est transmise via le pipeline à la cmdlet For-Each-Object. Celle-ci exécute Set-CsEdgeServer sur chaque serveur de la collection, modifiant les valeurs attribuées aux propriétés AccessInternalSipPort et AccessExternalSipPort.