Get-CsAdUser
Última modificación del tema: 2012-03-23
Devuelve información sobre todas las cuentas de usuario de Active Directory Domain Services (AD DS). Incluye las cuentas de usuario habilitadas para Microsoft Lync Server 2010 y las cuentas no habilitadas para Lync Server 2010.
Sintaxis
Get-CsAdUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descripción detallada
Get-CsAdUser devuelve información sobre todas las cuentas de usuario de Active Directory, tanto las que están habilitadas como las que no lo están para Lync Server. Actúa de manera diferente a Get-CsUser, que devuelve información solo sobre cuentas de usuario habilitadas para Lync Server o una versión anterior del software (por ejemplo, Microsoft Office Communications Server 2007 R2).
Aunque coinciden parcialmente en sus resultados, el tipo de información que devuelven Get-CsAdUser y Get-CsUser también es diferente. En general, Get-CsUser devuelve valores de atributos de Active Directory relacionados específicamente con Lync Server. Por ejemplo, Get-CsUser puede comunicar qué directivas de Lync Server se han asignado a un usuario y el URI de línea asignado a dicho usuario, e indicar si se ha habilitado el usuario para Enterprise Voice. Estos atributos no formarán parte de una cuenta de usuario a no ser que dicho usuario se haya habilitado para Lync Server.
Get-CsAdUser, sin embargo, devuelve valores de atributos genéricos de Active Directory; es decir, información sobre atributos que forman parte de la cuenta de usuario básica de Active Directory y que están presentes tanto si la cuenta está habilitada para Lync Server como si no lo está. Por ejemplo, Get-CsAdUser devuelve información como en qué departamento y organización trabaja el usuario, además del cargo, el número de teléfono y la dirección de la oficina. Para ver una lista completa de los valores de atributo que devuelve Get-CsAdUser, escriba este comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdUser | Get-Member
Get-CsAdUser permite filtrar de varias maneras la colección de usuarios que se obtiene al ejecutar este cmdlet. Por ejemplo, si no quiere ver todas las cuentas de usuario de Active Directory, puede aplicar los parámetros opcionales Filter o LdapFilter. Estos parámetros se excluyen mutuamente: si usa Filter en un comando, no puede usar también LdapFilter en el mismo comando, y viceversa. El parámetro Filter permite limitar los datos devueltos para obtener solo los usuarios que cumplan los criterios especificados para los atributos de Lync Server. Por ejemplo, puede usar el parámetro Filter para devolver una colección de usuarios que estén o no habilitados para Lync Server. EL parámetro LdapFilter permite limitar los datos devueltos para obtener únicamente los usuarios que cumplan otros criterios basados en atributos genéricos de Active Directory; por ejemplo, usuarios que trabajen en un estado o provincia específico, usuarios que tengan o no tengan un buscapersonas o usuarios con un cargo específico en la organización.
Una cosa importante a tener en cuenta sobre el cmdlet Get-CsAdUser es que, aunque el atributo Enabled, que determina si un usuario está habilitado para Lync Server, sea un valor booleano, esta propiedad en realidad tiene tres valores válidos:
True. Se ha habilitado al usuario para Lync Server
False. Se ha deshabilitado temporalmente la cuenta Lync Server del usuario. Esto se suele realizar con el cmdlet Set-CsUser y estableciendo el parámetro Enabled en $False.
Null. No se ha habilitado al usuario para Lync Server.
Lo que esto significa es que, si quiere devolver una lista de usuarios que no estén habilitados para Lync Server, debe utilizar un comando que devuelva todos los usuarios en los que el atributo Enabled sea null:
Get-CsAdUser –Filter {Enabled –eq $Null}
En cambio, el comando siguiente solo devuelve aquellos usuarios que tengan cuentas Lync Server que se hayan deshabilitado temporalmente:
Get-CsAdUser –Filter {Enabled –eq $False}
Los usuarios que no se hayan habilitado para Lync Server no se devolverán al ejecutar el comando anterior.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsAdUser localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdUser"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Parámetro UserID |
Indica la identidad de la cuenta de usuario que se recuperará. Las identidades de usuario pueden especificarse con cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). También puede hacer referencia a una cuenta de usuario por medio del nombre distintivo de Active Directory del usuario. Puede usar el asterisco (*) como comodín al usar el Nombre para mostrar como identidad del usuario. Por ejemplo, la Identidad "* Smith" devuelve todos los usuarios cuyo nombre para mostrar termine con el valor de cadena " Smith". |
Credential |
Opcional |
Objeto PSCredential |
Permite ejecutar el cmdlet Get-CsAdUser con credenciales alternativas. Puede ser necesario si la cuenta que usó para iniciar sesión en Windows no tiene los privilegios necesarios para trabajar con objetos de usuario. Para usar el parámetro Credential, primero debe crear un objeto PSCredential con el cmdlet Get-Credential. Si necesita información detallada, consulte el tema de ayuda Get-Credential. |
DomainController |
Opcional |
Cadena de caracteres |
Permite conectarse al controlador de dominio especificado para recuperar información de usuario. Para conectarse a un controlador de dominio específico, incluya el parámetro DomainController seguido del nombre de dominio completo (por ejemplo, atl-cs-001.litwareinc.com). |
Filter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos específicos de Lync Server. El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que devuelve solo los usuarios que no están habilitados para Lync Server tendría este aspecto: {Enabled -ne $True}, donde Enabled representa el atributo de Active Directory; -ne, el operador de comparación (no igual a), y $True (una variable integrada de Windows PowerShell), el valor True. |
LdapFilter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos genéricos de Active Directory; es decir, los atributos que no son específicos de Lync Server. Por ejemplo, puede limitar los datos devueltos a usuarios que trabajan en un departamento específico o usuarios con un cargo determinado. El parámetro LdapFilter usa el lenguaje de consulta LDAP al crear filtros. Por ejemplo, un filtro que devuelva sólo usuarios que trabajen en la cuidad de Redmond tendría este aspecto: "l=Redmond", donde "l" (L minúscula) representa el atributo de Active Directory (locality); "=" representa el operador de comparación (igual a); y "Redmond" representa el valor del filtro. |
OU |
Opcional |
Nombre distintivo |
Permite devolver los usuarios de una unidad organizativa (OU) o contenedor de Active Directory. Este parámetro devuelve datos de la unidad organizativa principal especificada y de cualquier otra unidad organizativa que contenga. Por ejemplo, si la OU Finance contiene dos unidades organizativas (AccountsPayable y AccountsReceivable), se devolverán usuarios de las tres unidades organizativas. Al especificar una OU, use el nombre distintivo (DN) del contenedor; por ejemplo: OU=Finance,dc=litwareinc,dc=com. Para devolver los usuarios del contenedor Users, use la siguiente sintaxis: cn=Users,dc=litwareinc,dc=com. |
ResultSize |
Opcional |
Entero |
Permite limitar el número de registros que devuelve el cmdlet. Por ejemplo, para que se devuelvan siete usuarios (al margen de la cantidad de usuarios que haya en el bosque), incluya el parámetro ResultSize y establezca el valor del parámetro en 7. Tenga en cuenta que no es posible especificar qué siete usuarios se devolverán. El tamaño del resultado puede definirse en cualquier número entero entre 0 y 2147483647, ambos incluidos. Si se establece en 0, el comando se ejecutará pero no devolverá datos. Si se define el valor 7 para el parámetro ResultSize pero solo hay tres usuarios en el bosque, el comando devolverá esos tres usuarios y se completará sin errores. |
Tipos de entrada
Cadena de caracteres. Get-CsAdUser acepta un valor de cadena transferido que represente el parámetro Identity de una cuenta de usuario de Active Directory.
Tipos de valores devueltos
Get-CsAdUser devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.CSADUser.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsAdUser
El comando del ejemplo 1 devuelve una colección de todas las cuentas de usuario del dominio de Active Directory.
-------------------------- Ejemplo 2 --------------------------
Get-CsAdUser -Identity "Pilar Ackerman"
En el Ejemplo 2, Get-CsAdUser devuelve la información de la cuenta de usuario de Pilar Ackerman. En este ejemplo, se usa el nombre para mostrar del usuario para especificar su parámetro Identity.
-------------------------- Ejemplo 3 --------------------------
Get-CsAdUser -OU "ou=Finance,dc=litwareinc,dc=com"
En el Ejemplo 3 se devuelve la información de cuenta de usuario de todos los usuarios que hay en la unidad organizativa Finance. Para ello, el DN de la OU debe pasarse al parámetro OU.
-------------------------- Ejemplo 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Select-Object DisplayName
En el comando anterior, se devuelven todos los usuarios que no se han habilitado para Lync Server 2010 o Office Communications Server. Para ello, se usa el parámetro Filter con Get-CsAdUser a fin de restringir los datos devueltos a las cuentas de usuario en las que la propiedad Enabled no sea igual a True. Este filtro indica a Get-CsAdUser que debe devolver únicamente cuentas de usuario que no se hayan habilitado para su uso con Lync Server o Office Communications Server. Después de recuperar los datos, la información se transfiere al cmdlet Select-Object, que identifica la única propiedad (en este caso, DisplayName) que se mostrará en pantalla.
-------------------------- Ejemplo 5 --------------------------
Get-CsAdUser -LdapFilter "Department=Finance"
En el ejemplo 5 se usa el parámetro LdapFilter para limitar los datos devueltos y obtener únicamente los usuarios que trabajan en el departamento Finance. Esto se realiza usando el valor de filtro LDAP "Department=Finance".