Set-CsDirector
Dernière rubrique modifiée : 2012-03-27
Modifie les propriétés d’un ou plusieurs directeurs. Les directeurs peuvent être utilisés pour authentifier les requêtes des utilisateurs, mais n’hébergent pas leurs comptes.
Syntaxe
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le directeur authentifie les utilisateurs et répond à leurs requêtes sans héberger de comptes d’utilisateurs. On utilise habituellement les directeurs pour les organisations qui autorisent l’accès à leur réseau aux utilisateurs externes par le biais de serveurs Edge. Dans ce scénario, les directeurs allègent non seulement le fardeau des serveurs frontaux (en gérant les requêtes d’authentification) mais facilitent également la protection du réseau interne contre les attaques par déni de service et autre trafics malicieux. Les directeurs sont également utiles pour les serveurs frontaux multiples déployés sur un site central. Dans ce cas, les directeurs reçoivent les requêtes des utilisateurs et les acheminent ensuite vers le pool de serveurs qui convient. Cela permet également de soulager les serveurs frontaux.
La cmdlet Set-CsDirector vous permet de modifier les valeurs de propriété relatives à tout directeur utilisé actuellement dans votre organisation. Cela implique de changer des éléments tels que le serveur d’archivage ou le serveur Edge associé au directeur ou de changer le port utilisé pour envoyer et recevoir le trafic SIP.
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-CsDirector : 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-CsDirector"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Emplacement de service du directeur à modifier. Par exemple : -Identity "Director:atl-cs-001.litwareinc.com". Notez que vous pouvez supprimer le préfixe « Director: » pour spécifier un directeur. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Facultatif |
Chaîne |
Emplacement de service du serveur d’archivage à associer au directeur. Par exemple : -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
EdgeServer |
Facultatif |
Chaîne |
Emplacement de service du serveur Edge à associer au directeur. Par exemple : -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
Facultatif |
Chaîne |
Emplacement de service du serveur de surveillance à associer au directeur. Par exemple : -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
SipPort |
Facultatif |
Entier |
Port utilisé pour le trafic SIP (Session Initiation Protocol). |
SipHealthPort |
Facultatif |
Entier |
Port utilisé pour surveiller l’intégrité du serveur. |
SipServerTcpPort |
Facultatif |
Entier |
Port d’écoute SIP. La valeur par défaut est 5060. |
WebPort |
Facultatif |
Entier |
Port utilisé pour communiquer avec les services Web. |
WebServer |
Facultatif |
Chaîne |
Emplacement des services Web du serveur à associer au directeur. Par exemple : -WebServer "WebServer: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 |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Set-CsDirector n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsDirector ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.Xds.DisplayDirector.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
La commande illustrée à l’exemple 1 modifie le serveur d’archivage associé au directeur Director:atl-cs-001.litwareinc.com. Dans cet exemple, le serveur d’archivage est commuté vers l’adresse ArchivingServer:dublin-cs-001.litwareinc.com.
-------------------------- Exemple 2 --------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
La commande précédente change le port SIP pour tous les directeurs utilisés actuellement dans l’organisation. Pour ce faire, la commande appelle d’abord Get-CsService et le paramètre Director pour retourner une collection de tous les directeurs dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet ForEach-Object. À son tour, ForEach-Object exécute Set-CsDirector sur chaque site de la collection, en modifiant la valeur de la propriété SipPort sur 5072.