Get-CsUserPoolInfo
Última modificación del tema: 2012-03-23
Devuelve información sobre el grupo de registrador, grupo de registrador de reserva y grupo de Servicios de usuario a los que está asignado un usuario.
Sintaxis
Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]
Descripción detallada
Cuando un usuario está habilitado para Microsoft Lync Server 2010, debe estar alojado en un grupo de registrador. Este grupo se encarga de la autenticación del usuario y de controlar su estado y ubicación. Si necesita saber el grupo de registrador al que se ha asignado un usuario, podrá recuperar dicha información mediante un comando similar al siguiente:
Get-CsUser "Ken Myer" | Select-Object RegistrarPool
En muchos casos, posiblemente solo necesite saber el grupo de registrador del usuario. Sin embargo, en otros casos, posiblemente también quiera saber cosas como el grupo de registrador de reserva al que se ha asignado el usuario (es decir, el grupo que se usará si el grupo de registrador primario no está disponible); los nombres de los equipos individuales que componen estos grupos y el grupo de servicios de usuario al que se ha asignado el usuario. Se devolverá el tipo de información detallada al ejecutar el cmdlet Get-CsUserPoolInfo.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsUserPoolInfo localmente: 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-CsUserPoolInfo"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Parámetro de Id. de usuario |
Indica la identidad del usuario cuya información de grupo de usuarios se recuperará. Las identidades 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 Domain Services (AD DS) del usuario (por ejemplo, Ken Myer). También se puede hacer referencia a una cuenta de usuario mediante un 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" devolverá información a todos los usuarios que tienen un apellido para mostrar que finaliza con el valor de cadena " Smith". |
LocalStore |
Parámetro modificador |
Recupera la información del grupo de usuarios desde una réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí. |
Tipos de entrada
Cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsUser acepta un valor de cadena canalizado que represente SamAccountName de una cuenta de usuario habilitada para Lync Server 2010. El cmdlet también acepta entradas canalizadas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Get-CsUserPoolInfo devuelve instancias del objeto Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"
El comando anterior devuelve información del grupo de servidores de usuarios de un único usuario. usuario cuya dirección SIP es sip:kenmyer@litwareinc.com.
-------------------------- Ejemplo 2 --------------------------
Get-CsUser | Get-CsUserPoolInfo
En el ejemplo 2, se devuelve información del grupo de servidores de usuarios para todos los usuarios habilitados para Lync Server 2010. Para ello, el comando primero llama a Get-CsUser sin ningún parámetro para devolver una recopilación de todos los usuarios habilitados para Lync Server. A continuación, la recopilación se canaliza a Get-CsUserPoolInfo, que mostrará la información del grupo de servidores de cada usuario de la recopilación.
-------------------------- Ejemplo 3 --------------------------
Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo
El comando que se muestra en el Ejemplo 3 es una variante del comando que se usa en el Ejemplo 2. En este ejemplo, se devuelve información del grupo de servidores para todos los usuarios habilitados para Lync Server. Sin embargo, es posible tener usuarios que estén habilitados para Lync Server, pero sin un grupo de registrador asignado. El comando que se ve en el Ejemplo 2 muestra un mensaje de error para cada usuario que cumple con esos criterios; esos mensajes de error se suprimen en el Ejemplo 3.
Para suprimir el mensaje de error, el Ejemplo 3 nuevamente emplea Get-CsUser para devolver una recopilación de todos los usuarios habilitados para Lync Server. Sin embargo, en este caso la recopilación se transfiere al cmdlet Where-Object, que selecciona sólo los usuarios cuya propiedad RegistrarPool no es igual a un valor nulo. (Es decir, los usuarios asignados a un grupo de registrador). Esta recopilación filtrada después se canaliza a Get-CsUserPoolInfo, que mostrará la información del grupo de servidores de cada usuario de la recopilación filtrada.
-------------------------- Ejemplo 4 --------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}
En el comando anterior, se muestra información de grupo de servidores de todos los usuarios que tienen asignado el grupo redmond-cs-001.litwareinc.com. Para ello, se llama a Get-CsUser para devolver una recopilación de todos los usuarios habilitados para Lync Server. A continuación, la recopilación se canaliza a Get-CsUserPoolInfo, que recuperará la información del grupo de servidores de cada usuario de la recopilación. Esta información de grupo de servidores se transfiere al cmdlet Where-Object, que selecciona sólo los usuarios cuya propiedad PrimaryPoolFqdn es igual a redmond-cs-001.litwareinc.com.
-------------------------- Ejemplo 5 --------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}
El comando del Ejemplo 5 devuelve la información de grupo de servidores de todos los usuarios no asignados a un grupo de registrador de reserva. Para ello, el comando llama a Get-CsUser para devolver una recopilación de todos los usuarios habilitados para Lync Server. Esta información después se canaliza a Get-CsUserPoolInfo, que recuperará la información del grupo de servidores de cada usuario de la recopilación. Finalmente, la información de grupo de servidores se transfiere al cmdlet Where-Object, que muestra sólo los datos de usuarios cuya propiedad BackupPoolFqdn es igual a un valor nulo.
-------------------------- Ejemplo 6 --------------------------
Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder
En el Ejemplo 6, se recupera información sobre los equipos que forman parte del grupo de registrador de Ken Myer. Para recuperar esta información, primero se llama a Get-CsUserPoolInfo a fin de devolver los datos relevantes de la cuenta de usuario de Ken Myer. Estos datos se transfieren al cmdlet Select-Object. Select-Object usa el parámetro Expand para "expandir" la información almacenada en la propiedad PrimaryPoolMachinesInPreferredOrder. Expandir una propiedad significa que todos los valores almacenados en dicha propiedad se muestran en pantalla en un formato de fácil lectura.