Get-CsUserPoolInfo
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur le pool de serveurs d’inscriptions, le pool de serveurs d’inscriptions de sauvegarde et le pool de services utilisateur auxquels un utilisateur a été affecté.
Syntaxe
Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]
Description détaillée
Lorsqu’un utilisateur est activé pour Microsoft Lync Server 2010, il doit être hébergé sur le pool de serveurs d’inscriptions. Ce pool est responsable de l’authentification de l’utilisateur et du suivi de son état et de son emplacement actuels. S’il vous faut savoir à quel pool de serveurs d’inscriptions l’utilisateur a été affecté, vous pouvez récupérer cette information en utilisant une commande similaire à celle-ci :
Get-CsUser "Ken Myer" | Select-Object RegistrarPool
Dans bien des cas, le fait de simplement connaître le pool de serveurs d’inscriptions de l’utilisateur peut suffire. Mais vous pouvez également souhaiter savoir à quel pool de serveurs d’inscriptions de sauvegarde l’utilisateur a été affecté (c’est-à-dire le pool à utiliser si le pool de serveurs d’inscriptions principal n’est pas disponible), le nom des ordinateurs individuels qui constituent ces pools et à quel pool de services d’utilisateurs l’utilisateur a été affecté. Ces informations détaillées peuvent être obtenues par l’exécution de la cmdlet Get-CsUserPoolInfo.
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-CsUserPoolInfo : 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-CsUserPoolInfo"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Paramètre ID utilisateur |
Indique l’identité de l’utilisateur dont les informations de pool utilisateur doivent être récupérées. Les identités peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet services de domaine Active Directory (AD DS) de l’utilisateur (par exemple, Ken Myer). Vous pouvez également faire référence à un compte d’utilisateur en utilisant son nom unique Active Directory. Vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » renvoie les informations des utilisateurs dont le nom de famille se termine par la valeur de chaîne « Smith ». |
LocalStore |
Paramètre de commutateur |
Récupère les informations sur le pool utilisateur à partir du réplica local du magasin central de gestion et non du magasin central de gestion même. |
Types d’entrées
Objet String ou Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsUser accepte une valeur de chaîne transmise par pipeline représentant le SamAccountName d’un compte d’utilisateur qui a été activé pour Lync Server 2010. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Get-CsUserPoolInfo retourne les instances de l’objet Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"
La commande précédente retourne des informations de pool d’utilisateurs pour un utilisateur unique : l’utilisateur avec l’adresse SIP sip:kenmyer@litwareinc.com.
-------------------------- Exemple 2 --------------------------
Get-CsUser | Get-CsUserPoolInfo
Dans l’exemple 2, les informations du pool d’utilisateurs sont renvoyées pour tous les utilisateurs qui ont été activés sous Lync Server 2010. Pour effectuer cette tâche, la commande appelle d’abord Get-CsUser sans paramètre afin de retourner une collection de tous les utilisateurs activés pour Lync Server. Cette collection est ensuite redirigée vers Get-CsUserPoolInfo qui affiche les informations du pool pour chaque utilisateur de la collection.
-------------------------- Exemple 3 --------------------------
Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo
La commande présentée dans l’exemple 3 est une variante de celle affichée dans le deuxième exemple. Dans l’exemple 2, les informations de pool sont renvoyées pour tous les utilisateurs activés pour Lync Server. Toutefois, il est possible que des utilisateurs ayant été activés pour Lync Server n’aient pas été affectés à un pool de serveurs d’inscriptions. La commande de l’exemple 2 affiche un message d’erreur pour chaque utilisateur qui répond à ces critères. Ces messages d’erreur sont supprimés dans l’exemple 3.
Pour supprimer le message d’erreur, l’exemple 3 utilise de nouveau la cmdlet Get-CsUser pour retourner une collection de tous les utilisateurs activés pour Lync Server. Toutefois, la collection est ici redirigée vers la cmdlet Where-Object, qui choisit uniquement les utilisateurs dont la propriété RegistrarPool est différente d’une valeur null. (En d’autres termes, les utilisateurs qui ont été affectés à un pool de serveurs d’inscriptions). Cette collection filtrée est ensuite redirigée vers Get-CsUserPoolInfo qui affiche les informations du pool pour chaque utilisateur de la collection.
-------------------------- Exemple 4 --------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}
Dans la commande précédente, des informations de pool sont affichées pour tous les utilisateurs qui ont été affectés au pool principal redmond-cs-001.litwareinc.com. Pour cela, Get-CsUser est appelée pour retourner une collection de tous les utilisateurs qui ont été activés pour Lync Server. Cette collection est ensuite redirigée vers Get-CsUserPoolInfo qui récupère les informations du pool pour chaque utilisateur de la collection. Ces informations de pool sont à leur tour redirigées vers la cmdlet Where-Object qui sélectionne uniquement les utilisateurs dont la propriété PrimaryPoolFqdn est égale à redmond-cs-001.litwareinc.com.
-------------------------- Exemple 5 --------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}
La commande présentée dans l’exemple 5 retourne des informations de pool pour tous les utilisateurs qui n’ont pas été affectés à un pool de serveurs d’inscriptions de sauvegarde. Pour effectuer cette tâche, la commande appelle d’abord Get-CsUser pour renvoyer une collection de tous les utilisateurs qui ont été activés pour Lync Server. Cette collection est ensuite redirigée vers Get-CsUserPoolInfo qui récupère les informations du pool pour chaque utilisateur de la collection. Enfin, ces informations de pool sont redirigées vers Where-Object, qui affiche des données uniquement pour les utilisateurs dont la propriété BackupPoolFqdn est égale à une valeur null.
-------------------------- Exemple 6 ------------------------
Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder
Dans l’exemple 6, des informations s’affichent sur les ordinateurs qui composent le pool de serveurs d’inscriptions de Ken Myer. Pour récupérer ces informations, on appelle d’abord Get-CsUserPoolInfo afin de retourner les données pertinentes concernant le compte de l’utilisateur Ken Myer. Cette collection est redirigée vers la cmdlet Select-Object. Select-Object utilise le paramètre Expand pour « développer » les informations stockées dans la propriété PrimaryPoolMachinesInPreferredOrder. Le développement d’une propriété signifie que toutes les valeurs stockées dans cette propriété s’affichent à l’écran dans un format lisible.