Get-CsAdUser
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur tous les comptes d’utilisateurs des services de domaine Active Directory (AD DS). Ceci inclut les comptes d’utilisateurs qui ont été activés pour Microsoft Lync Server 2010 ainsi que les comptes qui n’ont pas été activés pour Lync Server 2010.
Syntaxe
Get-CsAdUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Description détaillée
La cmdlet Get-CsAdUser retourne des informations sur tous les comptes d’utilisateurs présents dans Active Directory, y compris les comptes d’utilisateurs qui ont été activés pour Lync Server et ceux qui n’ont pas été activés pour celui-ci. Elle est différente de la cmdlet Get-CsUser, qui retourne des informations uniquement pour les utilisateurs dont les comptes ont été activés pour Lync Server ou une version antérieure du logiciel (telle que Microsoft Office Communications Server 2007 R2).
Même si les cmdlets Get-CsAdUser etGet-CsUser 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 est capable de vous dire quelles politiques Lync Server ont été assignée à un utilisateur, quelle ligne URI (Uniform Resource Identifier) a été affectée à cet utilisateur et indique si oui ou non l’utilisateur a été activé pour Enterprise Voice. Ces attributs ne feront pas partie d’un compte d’utilisateur tant que cet utilisateur n’aura pas été activé pour Lync Server.
À l’inverse, Get-CsAdUser retourne des valeurs d’attribut Active Directory génériques ; elle retourne ainsi des informations sur les attributs qui font partie du compte d’utilisateur Active Directory de base et qui sont présents, peu importe si l’utilisateur a été activé pour Lync Server. Par exemple, Get-CsAdUser renvoie des informations sur l’utilisateur, telles que le service et l’organisation où il travaille, sa fonction, son numéro de téléphone et son adresse professionnelle. Pour afficher une liste complète des valeurs d’attribut renvoyées par Get-CsAdUser, entrez la commande suivante à l’invite Windows PowerShell :
Get-CsAdUser | Get-Member.
Get-CsAdUser offre plusieurs façons de filtrer la collection d’utilisateurs retournée lorsque vous exécutez la cmdlet. Par exemple, si vous ne souhaitez pas voir tous vos comptes d’utilisateurs Active Directory, vous pouvez appliquer le paramètre facultatif 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. La paramètre de filtre vous permet de limiter les données renvoyées aux utilisateurs qui satisfont aux critères des attributs spécifiques à Lync Server. Par exemple, vous pouvez utiliser le paramètre Filter pour retourner une collection d’utilisateurs qui ont été ou n’ont pas été activés pour Lync Server. Le paramètre LdapFilter vous permet de restreindre les données renvoyées pour les utilisateurs qui remplissent d’autres critères basés sur les attributs d’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.
Point important à signaler en ce qui concerne la cmdlet Get-CsAdUser : bien que l’attribut Enabled, qui détermine si un utilisateur a été activé ou non pour Lync Server, soit une valeur booléenne, cette propriété a en fait trois valeurs valides :
True. L’utilisateur a été activé pour Lync Server.
False. Le compte Lync Server de l’utilisateur a été temporairement désactivé. En règle générale, cela se produit lorsque vous utilisez la cmdlet Set-CsUser et que vous affectez la valeur $False au paramètre Enabled.
Null. L’utilisateur n’a pas été activé pour Lync Server.
En d’autres termes, si vous souhaitez renvoyer une liste d’utilisateurs non activés pour Lync Server, vous devez utiliser une commande qui renvoie tous les utilisateurs pour lesquels l’attribut Enabled a la valeur Null :
Get-CsAdUser –Filter {Enabled –eq $Null}
En revanche, la commande suivante renvoie uniquement les utilisateurs qui disposent de comptes Lync Server ayant été temporairement désactivés :
Get-CsAdUser –Filter {Enabled –eq $False}
Les utilisateurs qui n’ont pas été activés pour Lync Server ne sont pas renvoyés lorsque vous exécutez la commande précédente.
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-CsAdUser : 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-CsAdUser"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Paramètre UserID |
Indique l’identité du compte d’utilisateur à récupérer. 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 en tant qu'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 Credential PS |
Permet d’exécuter la cmdlet Get-CsAdUser avec d’autres informations d’identification. Il peut être requis si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets de contact. 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 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 complet (FQDN) (par exemple, atl-cs-001.litwareinc.com). |
Filter |
Facultatif |
Chaîne |
Vous permet de limiter les données retournées en filtrant les attributs spécifiques à Lync Server. Le paramètre Filter utilise 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 n’ont pas été activés pour Lync Server se présente comme suit : {Enabled -ne $True}, où Enabled correspond à l’attribut Active Directory, -ne correspond à l’opérateur de comparaison (différent de) et $True (variable Windows PowerShell intégrée) correspond à la valeur 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 qui ont un responsable ou une fonction 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. |
OU |
Facultatif |
Nom unique |
Permet de retourner les utilisateurs à partir d’une unité d’organisation (OU) ou d’un conteneur Active Directory spécifique. Ce paramètre retourne 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 retourné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=Finance,dc=litwareinc,dc=com. Pour retourner les utilisateurs du conteneur Users, utilisez la syntaxe suivante : cn=Users,dc=litwareinc,dc=com. |
ResultSize |
Facultatif |
Entier |
Vous permet de limiter le nombre d’enregistrements renvoyés par une commande. 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 donnez-lui la valeur 7. Notez qu’il est impossible de savoir quels seront les sept utilisateurs retournés. La taille des résultats peut être définie pour n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini à 0, la commande s’exécutera, mais aucune donnée ne sera renvoyée. Si vous donnez à ResultSize la valeur 7, mais que votre forêt ne compte que trois utilisateurs, la commande retournera ces trois utilisateurs et se terminera sans erreur. |
Types d’entrées
Chaîne. Get-CsAdUser accepte une valeur de chaîne transmise via le pipeline représentant l’identité d’un compte d’utilisateur Active Directory.
Types de retours
Get-CsAdUser renvoie les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.CSADUser.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsAdUser
La commande présentée dans l’exemple 1 retourne une collection de tous les comptes d’utilisateurs contenus dans votre domaine Active Directory.
-------------------------- Exemple 2 --------------------------
Get-CsAdUser -Identity "Pilar Ackerman"
Dans l’exemple 2, Get-CsAdUser renvoie les informations de compte d’utilisateur relatives à Pilar Ackerman. Dans cet exemple, le nom complet de l’utilisateur est employé pour spécifier son identité.
-------------------------- Exemple 3 --------------------------
Get-CsAdUser -OU "ou=Finance,dc=litwareinc,dc=com"
L’exemple 3 renvoie les informations du compte utilisateur pour tous les utilisateurs de l’unité d’organisation finance. Pour ce faire, le nom unique de l’unité d’organisation (OU) doit être transmis au paramètre OU.
-------------------------- Exemple 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Select-Object DisplayName
Dans la commande précédente, tous les utilisateurs qui n’ont pas été activés pour Lync Server 2010 ou Office Communications Server sont retournés. Pour ce faire, le paramètre Filter est utilisé avec Get-CsAdUser pour limiter les données retournées aux comptes d’utilisateurs dans lesquels la propriété Enabled est différente de True. Ce filtre indique à Get-CsAdUser de retourner uniquement les comptes d’utilisateurs qui n’ont pas été activés pour être utilisés avec Lync Server ou Office Communications Server. Une fois les données récupérées, les informations sont redirigées vers la cmdlet Select-Object qui identifie alors la seule propriété (dans ce cas précis, DisplayName) qui sera affichée à l’écran.
-------------------------- Exemple 5 --------------------------
Get-CsAdUser -LdapFilter "Department=Finance"
Dans l’exemple 5, le paramètre LdapFilter est utilisé pour limiter les données retournées aux utilisateurs qui font partie du service Finance. Pour ce faire, la valeur Department=Finance du filtre LDAP est utilisée.