Get-CsUser
Dernière rubrique modifiée : 2012-03-23
Renvoie des informations sur tous les utilisateurs de votre organisation qui ont été activés pour Microsoft Lync Server 2010 ou une version antérieure du logiciel (telle que Microsoft Office Communications Server 2007 R2).
Syntaxe
Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnLyncServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnAssignedUser <SwitchParameter>]
Description détaillée
Combinées ensemble, les cmdlets Get-CsAdUser et Get-CsUser vous permettent de renvoyer des informations détaillées sur tous les comptes d’utilisateurs Active Directory. Get-CsAdUser retourne des informations sur tous vos comptes d’utilisateurs, y compris sur les utilisateurs qui ont été activés pour Lync Server 2010 ou Office Communications Server et les utilisateurs qui ne sont pas autorisés à utiliser Lync Server ou Office Communications Server. Cette cmdlet diffère de Get-CsUser qui retourne uniquement des informations sur les utilisateurs dont les comptes ont été activés pour Lync Server ou Office Communications Server.
Même si les cmdlets Get-CsUser et Get-CsAdUser ont des éléments en commun, elles diffèrent par le type d’informations qu’elles retournent. En règle générale, Get-CsUser retourne des valeurs pour les attributs Active Directory spécialement associés à Lync Server. Par exemple, Get-CsUser retourne des informations, telles que les stratégies Lync Server qui ont été affectées à un utilisateur, l’URI (Uniform Resource Identifier) de ligne affecté à cet utilisateur, et des informations détaillées indiquant si l’utilisateur a été activé pour Enterprise Voice. Ces attributs ne seront inclus dans un compte d’utilisateur que si cet utilisateur a été activé pour Lync Server.
En revanche, Get-CsAdUser retourne les valeurs d’attribut Active Directory génériques : les attributs faisant partie du compte d’utilisateur Active Directory de base et présents, qu’un utilisateur ait ou non été activé pour Lync Server. Par exemple, Get-CsAdUser renvoie des informations, telles que le service et l’organisation dont dépend l’utilisateur, ainsi que sa fonction, son numéro de téléphone et son adresse postale.
Pour afficher une liste complète des valeurs d’attribut retournées par Get-CsUser, tapez la commande suivante à l’invite Windows PowerShell :
Get-CsUser | Get-Member.
Get-CsUser offre plusieurs manières de filtrer l’ensemble d'utilisateurs renvoyé lorsque vous exécutez la cmdlet. Par exemple, si vous ne souhaitez pas renvoyer tous les comptes d’utilisateurs de Lync Server, vous pouvez appliquer les paramètres facultatifs Filter ou LDAPFilter (ces paramètres s’excluent mutuellement : si vous utilisez Filter dans une commande, vous ne pouvez pas utiliser LDAPFilter dans la même commande et vice versa). Le paramètre Filter vous permet de limiter les données renvoyées aux utilisateurs qui remplissent les critères spécifiés pour Lync Server. Par exemple, vous pouvez renvoyer uniquement les utilisateurs disposant de comptes dans le pool de serveurs d’inscriptions spécifié ou uniquement les utilisateurs qui ont été activés pour Enterprise Voice. Le paramètre LDAPFilter vous permet de restreindre les données renvoyées aux utilisateurs qui remplissent d’autres critères basés sur Active Directory, par exemple, les utilisateurs qui travaillent dans un État ou une province spécifique, les utilisateurs qui ont ou n’ont pas de récepteur de radiomessagerie ou encore les utilisateurs qui occupent une fonction spécifique.
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-CsUser : 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-CsUser\b"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Paramètre ID utilisateur |
Indique l’identité du compte d’utilisateur à extraire. Les identités utilisateur 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 Active Directory 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 tous les utilisateurs dont le nom complet se termine par la valeur de chaîne « Smith ». |
Credential |
Facultatif |
Objet PSCredential |
Vous permet d’exécuter la cmdlet Get-CsUser sous d’autres informations d’identification. Cela peut être nécessaire si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler des objets Utilisateur. Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide relative à la cmdlet Get-Credential. |
DomainController |
Facultatif |
Chaîne |
Vous permet de vous connecter au contrôleur de domaine spécifié afin d’extraire des informations sur l’utilisateur. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de domaine complet (FQDN) (par exemple, atl-cs-001.litwareinc.com). |
Filter |
Facultatif |
Chaîne |
Vous permet de limiter les données renvoyées en filtrant les attributs spécifiques à Lync Server. Par exemple, vous pouvez limiter les données renvoyées aux utilisateurs auxquels une stratégie de voix spécifique a été attribuée ou aux utilisateurs auxquels aucune stratégie de voix spécifique n’a été attribuée. Le paramètre Filter fait appel à la même syntaxe de filtrage Windows PowerShell que celle utilisée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement les utilisateurs qui ont été activés pour Enterprise Voice ressemblerait à ceci, avec EnterpriseVoiceEnabled représentant l’attribut Active Directory, - eq représentant l’opérateur de comparaison (égal à) et $True (variable intégrée de Windows PowerShell) représentant la valeur du filtre : {EnterpriseVoiceEnabled -eq $True} |
LDAPFilter |
Facultatif |
Chaîne |
Permet de limiter les données retournées en filtrant les attributs Active Directory génériques (c’est-à-dire les attributs qui ne sont pas spécifiques à Lync Server). Par exemple, vous pouvez limiter les données renvoyées aux utilisateurs qui travaillent dans un service donné ou aux utilisateurs rapportant à un supérieur ou occupant un poste spécifique. Le paramètre LDAPFilter utilise le langage de requête LDAP lors de la création des filtres. Par exemple, un filtre qui renvoie uniquement les utilisateurs travaillant dans la ville de Redmond se présente comme suit : « l=Redmond », où « l » (soit un L minuscule) correspond à l’attribut Active Directory (localité), « = » correspond à l’opérateur de comparaison (égal à) et « Redmond » correspond à la valeur de filtre. |
OnOfficeCommunicationServer |
Facultatif |
Paramètre de commutateur |
Retourne un ensemble d’utilisateurs hébergés sur une version antérieure de Lync Server (par exemple, Office Communications Server 2007 R2). Les utilisateurs disposant de comptes hébergés sur la version antérieure du logiciel ne sont pas renvoyés lorsque vous utilisez ce paramètre. |
OnLyncServer |
Facultatif |
Paramètre de commutateur |
Renvoie un ensemble d’utilisateurs hébergés sur Lync Server 2010. Les utilisateurs disposant de comptes hébergés sur des versions antérieures du logiciel ne sont pas renvoyés lorsque vous utilisez ce paramètre. |
OU |
Facultatif |
Nom unique |
Vous permet de retourner des informations sur les comptes d’utilisateurs d’une unité d’organisation (OU) ou d'un conteneur spécifique. Le paramètre OU renvoie les données provenant de l’unité d’organisation (OU) spécifiée et de toutes ses unités d’organisation enfants. Par exemple, si l’unité d’organisation Finance compte deux unités d’organisation enfants, AccountsPayable et AccountsReceivable, les utilisateurs seront renvoyés par chacune de ces trois unités d’organisation. Lors de la spécification d’une unité d’organisation (OU), utilisez le nom unique de ce conteneur ; par exemple : -OU "OU=Finance,dc=litwareinc,dc=com". Pour retourner les comptes d'utilisateur du conteneur Users, utilisez la syntaxe suivante : -OU "cn=Users,dc=litwareinc,dc=com". |
ResultSize |
Facultatif |
Entier |
Vous permet de limiter le nombre d’enregistrements renvoyés par la cmdlet. Par exemple, pour retourner sept utilisateurs (quel que soit le nombre d’utilisateurs présents dans votre forêt), incluez le paramètre ResultSize et définissez sa valeur sur 7. Notez qu’il est impossible de savoir quels seront les sept utilisateurs retournés. La taille des résultats peut être définie sur n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini sur 0, la commande s’exécutera, mais aucune donnée ne sera renvoyée. Si vous définissez ResultSize sur 7, mais que votre forêt ne compte que trois utilisateurs, la commande renverra ces trois utilisateurs et se terminera sans erreur. |
UnassignedUser |
Facultatif |
Paramètre de commutateur |
Vous permet de renvoyer un ensemble de tous les utilisateurs qui ont été activés pour Lync Server, mais qui ne sont pas actuellement affectés à un pool de serveurs d’inscription. Les utilisateurs ne sont pas autorisés à se connecter à Lync Server, sauf s’ils sont affectés à un pool de serveurs d’inscription. |
Types d’entrées
Chaîne. Get-CsUser accepte une valeur de chaîne transmise par pipeline représentant le paramètre Indentity d’un compte d’utilisateur qui a été activé pour Lync Server 2010.
Types de retours
Get-CsUser renvoie des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsUser
Dans l’exemple précédent, Get-CsUser est appelé sans aucun paramètre afin de renvoyer un ensemble de tous les utilisateurs de domaine qui ont été activés pour Lync Server ou Office Communications Server.
-------------------------- Exemple 2 --------------------------
Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize
Dans l’exemple 2, Get-CsUser est réutilisé pour renvoyer un ensemble de tous les utilisateurs de domaine qui ont été activés pour Lync Server ou Office Communications Server. Par défaut, Get-CsUser renvoie un très grand nombre de propriétés et de valeurs de propriété, la plupart présentant peu d'intérêt dans une situation donnée. Par conséquent, dans cet exemple, les données extraites sont redirigées vers la cmdlet Format-Table. Format-Table utilise ensuite le paramètre Property pour sélectionner les propriétés DisplayName, SipAddress et EnterpriseVoiceEnabled, et présente ces propriétés ainsi que les valeurs correspondantes dans un tableau.
-------------------------- Exemple 3 --------------------------
Get-CsUser -Identity "Pilar Ackerman"
Dans l’exemple 3, le paramètre Identity est utilisé pour limiter les données renvoyées au compte d’utilisateur dont l’identité (dans ce cas, le nom complet) est Pilar Ackerman.
-------------------------- Exemple 4 --------------------------
Get-CsUser -Identity "Pilar*"
Dans l’exemple 4, le caractère générique (*) est utilisé pour spécifier l’identité de l’utilisateur. Get-CsUser alors renvoie tous les utilisateurs dont l’identité commence par la valeur de chaîne « Pilar ».
-------------------------- Exemple 5 --------------------------
Get-CsUser -Filter {VoicePolicy -eq $Null}
La commande illustrée dans l’exemple 5 renvoie un ensemble des utilisateurs auxquels une stratégie de voix utilisateur n’a pas été affectée. Pour cela, la commande utilise le paramètre Filter suivi du filtre VoicePolicy -eq "$Null. Lors de la création de filtres à utiliser avec Get-CsUser, vous devez spécifier le nom de la propriété (VoicePolicy) suivi de l’opérateur de comparaison (dans ce cas, « eq », l’opérateur signifiant « égal à »). L’opérateur de comparaison est immédiatement suivi de la valeur testée. Dans cet exemple, la valeur est $Null, une variable Windows PowerShell qui représente une valeur nulle.
Pour renvoyer un ensemble d'utilisateurs ayant une stratégie de voix affectée, utilisez cette commande :
Get-CsUser -Filter {VoicePolicy -ne $Null}
-------------------------- Exemple 6 --------------------------
Get-CsUser -LDAPFilter "Department=Finance"
La commande précédente utilise le paramètre LDAPFilter pour limiter les données renvoyées aux utilisateurs qui travaillent au sein du service Finance. Pour ce faire, la valeur Department=Finance du filtre LDAP est utilisée.
-------------------------- Exemple 7 --------------------------
Get-CsUser -LDAPFilter "&(Department=Finance)(Title=Manager)"
L’exemple 7 illustre l’utilisation d’une requête AND en association avec le paramètre LDAPFilter. Cette requête (qui utilise le et commercial « & » pour indiquer une requête AND) spécifie deux conditions : « Department=Finance » et « Title=Manager ». Pour que cette requête renvoie un compte d’utilisateur, deux conditions doivent être remplies : un utilisateur doit travailler au sein du service Finance et être un supérieur.
-------------------------- Exemple 8 --------------------------
Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"
Dans la commande illustrée dans l’exemple 8, une requête OR (indiquée par la barre verticale « | » est utilisée avec le paramètre LDAPFilter. Dans la requête AND illustrée dans l’exemple 7, les deux conditions devaient être remplies pour qu’un compte d’utilisateur soit renvoyé. Dans une requête OR, une seule condition doit être remplie pour que le compte soit renvoyé. Dans ce cas, un compte d’utilisateur sera renvoyé si l’utilisateur est un superviseur ou un supérieur.
-------------------------- Exemple 9 --------------------------
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"
L’exemple 9 renvoie des informations sur les comptes d’utilisateur de tous les utilisateurs possédant des comptes dans l’OU Finance.
-------------------------- Exemple 10 --------------------------
Get-CsUser -UnassignedUser
La commande précédente renvoie un ensemble de tous les utilisateurs qui ont été activés pour Lync Server ou Office Communications Server, mais qui ne sont pas actuellement affectés à un pool de serveurs d’inscription.