Get-CsPool
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les pools utilisés dans votre déploiement Microsoft Lync Server 2010. Les pools sont une collection d’ordinateurs dans un site, qui exécutent tous le même ensemble de services Lync Server 2010.
Syntaxe
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
Description détaillée
Dans Lync Server 2010, un pool correspond à un ou plusieurs ordinateurs dans le même site, qui exécutent le même ensemble de services. Par exemple, si vous avez un serveur exécutant le service de serveur de médiation sur le site Redmond, vous avez alors un pool de service de serveur de médiation constitué d’un seul ordinateur. Si vous avez deux ordinateurs exécutant le serveur de médiation sur le site Redmond, vous avez alors un pool de serveur de médiation constitué de deux ordinateurs. Le nombre de pools utilisés dans votre organisation dépend du nombre de serveurs dont vous disposez et des différents services exécutés par ces serveurs.
La cmdlet Get-CsPool permet de récupérer des informations sur chaque pool utilisé dans votre organisation, y compris des informations sur les services qui s’exécutent sur chacun de ces pools.
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-CsPool : 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-CsPool"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du pool à retourner. Par exemple : -Identity atl-cs-001.litwareinc.com. Si ce paramètre n’est pas présent, tous les pools de votre organisation seront retournés. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques lors de la spécification de l’identité du ou des pools à retourner. Par exemple, cette syntaxe retourne tous les pools ayant une identité qui se termine par la valeur de chaîne « .fabrikam.com » : -Filter "*.fabrikam.com". Notez que vous ne pouvez pas utiliser les paramètres Filter et Identity dans la même commande. |
Site |
Facultatif |
Chaîne |
Retourne tous les pools trouvés sur le site spécifié. Le site en question doit être référencé à l’aide de la valeur DisplayName du site (par exemple, Redmond) plutôt qu’à l’aide de l’identité du site (par exemple, site:Redmond). Par exemple : -Site "Redmond". Vous pouvez récupérer les noms complets pour les sites exécutant cette commande : Get-CsSite | Select-Object Identity, DisplayName |
Types d’entrées
Aucun. Get-CsPool n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsPool retourne les instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.Cluster.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsPool
La commande précédente retourne tous les pools de votre déploiement Lync Server.
-------------------------- Exemple 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
L’exemple 2 affiche des informations détaillées sur les ordinateurs de chaque pool. Pour ce faire, Get-CsPool est appelée, puis les données retournées sont redirigées vers la cmdlet Select-Object. Le paramètre ExpandProperty de Select-Object est utilisé pour « développer » la valeur de la propriété Computers. La propriété Computers est en réalité un groupe d’objets représentant chaque ordinateur du pool. Lorsque vous développez la propriété Computers, vous obtenez des informations détaillées sur chacun de ces ordinateurs.
-------------------------- Exemple 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
Dans l’exemple précédent, le paramètre Identity est utilisé pour restreindre les données retournées à un pool dont l’identité est atl-cs-001.litwareinc.com.
-------------------------- Exemple 4 --------------------------
Get-CsPool -Site "Redmond"
L’exemple 4 retourne tous les pools trouvés dans le site Redmond. Pour ce faire, la commande utilise le paramètre Site. La valeur de paramètre « Redmond » limite les données retournées aux pools dont la propriété Site est égale à Redmond.
-------------------------- Exemple 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
La commande présentée dans l’exemple 5 retourne une collection de tous les pools pour lesquels Lync Server n’est pas installé. Pour cela, la commande appelle d’abord Get-CsPool sans paramètre ; cet appel retourne une collection de tous les pools actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne tous les pools dont la propriété Services.Count est égale à 0. Si Count est égal à 0, il n’y a aucun service Lync Server configuré pour ce pool.