Get-CsSite
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les sites créés dans le cadre de votre infrastructure 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
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
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 un rôle clé dans la gestion de Lync Server : la plupart des 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.
La cmdlet Get-CsSite vous permet de renvoyer des informations sur tous les sites de votre organisation, y compris sur les pools composant chacun de ces sites.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsSite : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsSite"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
SiteId |
Nom du site à renvoyer. Notez que seul le nom du site doit être spécifié. Par exemple : -Identity "Redmond". N’utilisez pas le format « site:Redmond » pour spécifier l’identité. |
Filter |
Facultatif |
Chaîne |
Vous permet d’utiliser des caractères génériques lors de la spécification de l’identité du ou des sites à renvoyer. Par exemple, la syntaxe suivante renvoie tous les pools dont l’identité inclut la valeur de chaîne « Dublin » : -Filter « *Dublin* ». Notez que vous ne pouvez pas utiliser les paramètres Filter et Identity dans la même commande. |
Types d’entrées
Aucun. Get-CsSite n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsSite renvoie des instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsSite
Dans l’exemple 1, les informations relatives à tous vos sites Lync Server sont renvoyées.
-------------------------- Exemple 2 --------------------------
Get-CsSite -Identity "Redmond"
Dans l’exemple 2, les informations renvoyées concernent un seul site unique : le site comportant l’identité Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
La commande illustrée dans l’exemple 3 renvoie des informations sur votre site central. Pour exécuter cette tâche, la commande appelle d’abord la cmdlet Get-CsSite pour renvoyer un ensemble de tous les sites configurés pour être utilisés dans votre organisation. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement le site dont la propriété SiteType est égale à « CentralSite ».
-------------------------- Exemple 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
La commande précédente affiche la liste des pools trouvés sur le site de Redmond. Pour ce faire, la commande extrait d’abord les informations détaillées sur le site de Redmond, puis redirige ces données vers la cmdlet Select-Object. Select-Object utilise ensuite le paramètre ExpandProperty correspondant pour « développer » la valeur de la propriété Pools. La développement d’une valeur de propriété signifie que toutes les valeurs stockées dans cette propriété s’affichent à l’écran dans un format lisible.