Set-CsSite
Dernière rubrique modifiée : 2012-03-26
Modifie les propriétés de vos sites Microsoft Lync Server 2010. Les sites représentent une collection de pools Lync Server 2010 et sont généralement conçus autour de régions géographiques. Lync Server comprend deux types de sites : les sites de centre de données et les sites distants (succursales).
Syntaxe
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Lync Server 2010 introduit un nouveau concept à la topologie Lync Server : les sites. Les sites (qui ne doivent pas être confondus avec les sites Active Directory ou les sites Microsoft Exchange Server) représentent un ensemble de pools et de serveurs Lync Server généralement organisés par zone géographique et bande passante réseau. Par exemple, si tous vos ordinateurs de Redmond sont situés sur le même réseau local et équipés de connexions haut débit à faible latence, vous pouvez désigner un site de Redmond qui englobe tous ces ordinateurs. Si vos ordinateurs de Dublin sont situés sur leur propre réseau local et qu’ils partagent des connexions haut débit à faible latence, vous pouvez également créer un site Dublin distinct. Les sites jouent également un rôle clé dans la gestion de Lync Server : de nombreuses stratégies et paramètres peuvent être configurés dans l’étendue Site, ce qui facilite, par exemple, l’application d’un ensemble de plans de numérotation aux utilisateurs de Redmond et d’un ensemble distinct de plans de numérotation aux utilisateurs de Dublin.
Les sites sont créés à l’aide de l’Générateur de topologies, et toutes les modifications apportées à l’infrastructure du site (par exemple, l’ajout de nouveaux pools) doivent également l’être au moyen de l’outil de création de topologies. Cependant, vous pouvez utiliser la cmdlet Set-CsSite pour modifier le nom complet, la description et/ou l’itinéraire de fédération d’un site dans votre organisation.
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-CsSite : 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-CsSite"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Nom du site à modifier (par exemple : -Identity "Redmond"). N’utilisez pas le format « site:Redmond » pour spécifier l’identité. |
Description |
Facultatif |
Chaîne |
Permet aux administrateurs d’ajouter des informations supplémentaires à un objet de site. Par exemple, la description peut inclure les informations de contact du site. |
DisplayName |
Facultatif |
Chaîne |
Nom convivial attribué au site. Par exemple : -DisplayName "North America and South America". |
FederationRoute |
Facultatif |
Chaîne |
L’emplacement de service du serveur Edge utilisé pour établir un pont entre votre réseau interne et Internet. Par exemple : -FederationRoute "EdgeServer:atl-edge-001.litwareinc.com". |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
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-CsSite n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsSite ne retourne ni objet, ni valeur. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
La commande présentée dans l’exemple 1 modifie la propriété Description du site Redmond (-Identity Redmond).
-------------------------- Exemple 2 ------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
La commande ci-dessus modifie et redéfinit le nom complet (DisplayName) du site Redmond sur US Headquarters.
-------------------------- Exemple 3 ------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
La commande présentée dans l’exemple 3 trouve tous les sites ne disposant pas de propriété Description, puis affecte à chacun de ces sites la description générique « Litwareinc.com ». Pour cela, la commande appelle d’abord la cmdlet Get-CsSite sans aucun paramètre afin de retourner une collection de tous les sites Lync Server. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les sites dont la propriété Description est égale à (-eq) une valeur Null ($Null). Ces sites sont ensuite redirigés vers la cmdlet ForEach-Object. Cette cmdlet récupère chaque élément de la collection et fait appel à la cmdlet Set-CsSite pour modifier la valeur de la propriété Description.