Get-CsUserDatabaseState
Última modificación del tema: 2012-03-23
Devuelve información sobre el estado en línea (True o False) de una o más bases de datos de usuario de Microsoft Lync Server 2010.
Sintaxis
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
Descripción detallada
Lync Server 2010 emplea la base de datos de usuario (también denominada almacén de usuario) para conservar la información de presencia y de enrutamiento de los usuarios de Lync Server. El cmdlet Get-CsUserDatabaseState permite comprobar el estado actual (en línea o sin conexión) de cualquier base de datos de usuario que esté actualmente en uso en la organización.
Tenga en cuenta que, de manera predeterminada, las excepciones de firewall para SQL Server Express no están habilitadas cuando se instala la versión Standard Edition de Lync Server 2010. Eso, a su vez, significa que no podrá ejecutar Get-CsUserDatabaseState desde una instancia remota de Windows PowerShell. El motivo es que su comando no podrá atravesar el firewall y obtener acceso a la base de datos SQL Server Express. Aunque sí podrá ejecutar cmdlet localmente, es decir, en el servidor Standard Edition. Sin embargo, para ejecutar Get-CsUserDatabaseState remotamente tendrá que habilitar manualmente las excepciones del firewall para SQL Server Express.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsUserDatabaseState de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserDatabaseState"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Identificador único de la base de datos de usuario cuyo estado en línea se va a devolver. Por ejemplo: -Identity "UserDatabase:atl-sql-001.litwareinc.com". No es posible usar Identity y RegistrarPool en el mismo comando, así como tampoco es posible usar caracteres comodín con ninguno de estos parámetros. Si se omiten ambos parámetros, Get-CsUserDatabaseState devuelve información sobre todas las bases de datos de usuario que estén actualmente en uso. |
RegistrarPool |
Opcional |
Cadena de caracteres |
Nombre de dominio completo del grupo de registrador que hospeda la base de datos de usuario cuyo estado en línea se va a devolver. Por ejemplo: -RegistrarPool "atl-cs-001.litwareinc.com". No es posible usar Identity y RegistrarPool en el mismo comando, así como tampoco es posible usar caracteres comodín con ninguno de estos parámetros. Si se omiten ambos parámetros, Get-CsUserDatabaseState devuelve información sobre todas las bases de datos de usuario que estén actualmente en uso. |
Tipos de entrada
Ninguno. Get-CsUserDatabaseState no acepta la entrada transferida.
Tipos de valores devueltos
Get-CsUserDatabaseState devuelve instancias del objeto Microsoft.Rtc.Management.Xds.UserStoreState.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsUserDatabaseState
El comando mostrado en el Ejemplo 1, devuelve el estado en línea de todas las bases de datos de usuario que están configuradas para su uso en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
El comando mostrado en el Ejemplo 2 devuelve el estado en línea de una sola base de datos de usuario: la bases de datos con la identidad UserDatabase:atl-sql-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
En el Ejemplo 3, se devuelve la información de estado de todas las bases de datos de usuario que se encuentren en el grupo de registrador atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
En el ejemplo anterior, se devuelve información de todas las bases de datos de usuario que estén en línea. Para ello, el comando primero llama a Get-CsUserDatabaseState sin ningún parámetro. Devuelve una colección de todas las bases de datos de usuario que estén en uso en la organización. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona las bases de datos cuya propiedad Online sea igual a True.