Get-CsUser
Última modificación del tema: 2012-03-23
Devuelve información acerca de todos los usuarios de la organización que han sido habilitados para Microsoft Lync Server 2010 o para una versión anterior del software (como Microsoft Office Communications Server 2007 R2).
Sintaxis
Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnLyncServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnAssignedUser <SwitchParameter>]
Descripción detallada
Usados en conjunto, los cmdlets Get-CsAdUser y Get-CsUser lo habilitan a recuperar información detallada acerca de todas sus cuentas de usuario de Active Directory. Get-CsAdUser devuelve información acerca de todas sus cuentas de usuario, incluidos tanto los usuarios que han sido habilitados para Lync Server 2010 o Office Communications Server aquellos que no han sido habilitados para Lync Server o Office Communications Server. Esta es la diferencia con Get-CsUser, que solo devuelve información acerca de aquellos usuarios cuyas cuentas han sido habilitadas para Lync Server o Office Communications Server.
Aunque los dos se superpongan, Get-CsUser y Get-CsAdUserdifieren en el tipo de información que devuelven. En general, Get-CsUser devuelve valores de atributos de Active Directory relacionados específicamente con Lync Server. Por ejemplo, Get-CsUser devuelve información como las directivas de Lync Server que se asignaron a un usuario; el Identificador Uniforme de Recursos (URI) de línea asignado a ese usuario y la información sobre si el usuario está habilitado para Telefonía IP empresarial. 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: atributos que forman parte de la cuenta de usuario básica de Active Directory y que están presentes tanto si la cuenta se ha habilitado para Lync Server como si no. Por ejemplo, Get-CsAdUser devuelve información como en qué departamento y organización trabaja el usuario, además de su puesto, número de teléfono y dirección de la oficina.
Para ver una lista completa de los valores de atributo que devuelve Get-CsUser, introduzca este símbolo del sistema en Windows PowerShell:
Get-CsUser | Get-Member
Get-CsUser permite filtrar de muchas maneras la recopilación de usuarios que se devuelven realmente al ejecutar este cmdlet. Por ejemplo, si no desea recibir todas las cuentas de usuario de Lync Server 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 lo habilita para limitar los datos devueltos a los usuarios que cumplan los criterios especificados para Lync Server; por ejemplo, se puede decidir devolver solo usuarios con cuentas en el grupo de registrador especificado o solo usuarios habilitados para Telefonía IP empresarial. EL parámetro LDAPFilter lo habilita para limitar los datos devueltos a los usuarios que cumplan otros criterios basados en 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 puesto específico en la organización.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsUser en forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUser\b"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
UserIDParameter |
Indica el parámetro Identity 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). Además se puede hacer referencia a la cuenta del usuario al usar el 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, el parámetro Identity "* Smith" devolvería todos los usuarios cuyo nombre para mostrar termine con el valor de cadena " Smith". |
Credential |
Opcional |
Objeto PSCredential |
Permite ejecutar el cmdlet Get-CsUser con credenciales alternativas. Esto puede ser necesario si la cuenta usada para iniciar sesión de 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 del cmdlet Get-Credential. |
DomainController |
Opcional |
Cadena de caracteres |
Permite conectarse al controlador de dominio especificado para recuperar información de usuarios. Para conectarse a un controlador de dominio específico, incluya el parámetro DomainController seguido del nombre de dominio completo (FQDN) (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. Por ejemplo, puede limitar los datos devueltos a usuarios con una directiva de voz específica asignada o a usuarios que no tengan una directiva de voz específica asignada. El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que sólo devuelve usuarios que se hayan habilitado para Telefonía IP empresarial tendría este aspecto, en el que EnterpriseVoiceEnabled representa el atributo de Active Directory, -eq representa el operador de comparación (igual a) y $True (una variable de Windows PowerShell integrada) representa el valor de filtro: {EnterpriseVoiceEnabled -eq $True} |
LDAPFilter |
Opcional |
Cadena de caracteres |
Lo habilita para limitar los datos que se devuelven mediante el filtrado de 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 solo usuarios que trabajen en la cuidad de Redmond tendría este aspecto: "l=Redmond", "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. |
OnOfficeCommunicationServer |
Opcional |
Parámetro modificador |
Devuelve una recopilación de usuarios de una versión anterior de Lync Server (por ejemplo, Office Communications Server 2007 R2). Aquellos usuarios que tengan cuentas de la versión actual del software no serán devueltos al usar este parámetro. |
OnLyncServer |
Opcional |
Parámetro modificador |
Devuelve una recopilación de usuarios de Lync Server 2010. Aquellos usuarios que tengan cuentas de versiones anteriores del software no serán devueltos al usar este parámetro. |
OU |
Opcional |
Nombre distintivo |
Lo habilita para devolver información sobre las cuentas de usuario de una unidad organizativa (OU) o un contenedor específico. El parámetro OU devuelve datos de la unidad organizativa principal especificada y cualquier otra OU 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 "OU=Finance,dc=litwareinc,dc=com". Para devolver las cuentas de usuario del contenedor de usuarios, use esta sintaxis: -OU "cn=Users,dc=litwareinc,dc=com". |
ResultSize |
Opcional |
Integer |
Permite limitar el número de registros que devuelve el cmdlet. Por ejemplo, para que se devuelvan siete usuarios (independientemente de la cantidad de usuarios que haya en el bosque), incluya el parámetro ResultSize y defina el valor del parámetro en 7. Tenga en cuenta que no es posible especificar qué 7 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 parámetro ResultSize en 7 pero solo hay tres usuarios en el bosque, el comando devolverá esos tres usuarios y se completará sin errores. |
UnassignedUser |
Opcional |
Parámetro modificador |
Lo habilita para devolver una recopilación de todos los usuarios que hayan sido habilitados para Lync Server pero que no están actualmente asignados a un grupo de registrador. Los usuarios no están habilitados para iniciar sesión de Lync Server, a menos que estén asignados a un grupo de registrador. |
Tipos de entrada
Cadena de caracteres. Get-CsUser acepta un valor de cadena canalizado que representa la identidad de una cuenta de usuario que ha sido habilitada para Lync Server 2010.
Tipos de valores devueltos
Get-CsUser devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsUser
En el ejemplo anterior, se llama a Get-CsUser sin ningún parámetro, para recuperar una recopilación de todos los usuarios del dominio que han sido habilitados para Lync Server o Office Communications Server.
-------------------------- Ejemplo 2 --------------------------
Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize
En el ejemplo 2, Get-CsUser devuelve una recopilación de todos los usuarios del dominio que han sido habilitados para Lync Server o Office Communications Server. De manera predeterminada, Get-CsUser devuelve una gran cantidad de propiedades y valores de propiedades, muchos de los cuales serán de poco interés en una situación particular. Por lo tanto, en este ejemplo los datos recuperados se transfieren al cmdlet Format-Table. Format-Table luego usa el parámetro Property para seleccionar las propiedades DisplayName, SipAddress y EnterpriseVoiceEnabled, y muestra esas cuatro propiedades con sus valores en una tabla.
-------------------------- Ejemplo 3 --------------------------
Get-CsUser -Identity "Pilar Ackerman"
En el Ejemplo 3, el parámetro Identity se usa para limitar los datos devueltos a la cuenta de usuario cuyo valor de Identity (en este caso, el nombre para mostrar) sea Pilar Ackerman.
-------------------------- Ejemplo 4 --------------------------
Get-CsUser -Identity "Pilar*"
En el Ejemplo 4, el comodín (*) se usa al especificar la el parámetro Identity del usuario. Como resultado, Get-CsUser devuelve todos los usuarios cuya identidad comienza con el valor de cadena "Pilar".
-------------------------- Ejemplo 5 --------------------------
Get-CsUser -Filter {VoicePolicy -eq $Null}
El comando mostrado en el Ejemplo 5 devuelve una recopilación de los usuarios que no tienen asignada una directiva de voz por usuario. Para ello, el comando usa el parámetro Filter seguido del filtro VoicePolicy -eq "$Null. Al construir filtros para ser usados con Get-CsUser, es necesario especificar el nombre de propiedad (VoicePolicy) seguido del operador de comparación (en este caso, "eq", el operador de comparación que significa "igual a"). Inmediatamente después del operador de comparación se ubica el valor que se está comprobando. En este ejemplo, ese valor es $Null, una variable de Windows PowerShell que representa un valor nulo.
Para devolver una recopilación de usuarios que no tienen una directiva de voz asignada, use este comando:
Get-CsUser -Filter {VoicePolicy -ne $Null}
-------------------------- Ejemplo 6 --------------------------
Get-CsUser -LDAPFilter "Department=Finance"
El comando anterior usa el parámetro LDAPFilter para limitar los datos devueltos a usuarios que trabajan en el departamento de finanzas (Finance). Para ello, se usa el valor de filtro LDAP "Department=Finance".
-------------------------- Ejemplo 7 --------------------------
Get-CsUser -LDAPFilter "&(Department=Finance)(Title=Manager)"
En el Ejemplo 7 se demuestra el uso de una consulta AND con el parámetro LDAPFilter. Esta consulta (que usa el carácter Y comercial "&" para indicar una consulta AND) especifica dos condiciones: "Department=Finance" and "Title=Manager". Para que esta consulta devuelva un usuario, ambas condiciones deben ser verdaderas: el usuario debe trabajar en el departamento de finanzas (Finance) y debe ser un administrador (Manager).
-------------------------- Ejemplo 8 --------------------------
Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"
En el comando que se muestra en el Ejemplo 8, se usa una consulta OR (indicada por el símbolo "|") con el parámetro LDAPFilter. En la consulta AND que se muestra en el Ejemplo 7 ambas condiciones deben ser verdaderas para que se devuelva una cuenta de usuario. Con una consulta OR solo una de las condiciones debe ser verdadera para que se devuelva la cuenta. En este caso, se devolverá una cuenta de usuario si el usuario es supervisor o si es administrador (Manager).
-------------------------- Ejemplo 9 --------------------------
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"
En el ejemplo 9 se devuelve información de las cuentas de todos los usuarios que pertenecen a la unidad organizativa Finance.
-------------------------- Ejemplo 10 --------------------------
Get-CsUser -UnassignedUser
El comando anterior permite recibir una recopilación de todos los usuarios que han sido habilitados para Lync Server o Office Communications Server pero no están actualmente asignados a un grupo de registrador.