Set-CsUserDatabaseState
Última modificación del tema: 2012-03-27
Habilita o deshabilita una o más bases de datos de usuario de Microsoft Lync Server 2010.
Sintaxis
Set-CsUserDatabaseState -Online <$true | $false> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsUserDatabaseState -Identity <String> -Online <$true | $false> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 Set-CsUserDatabaseState permite cambiar el estado de una o más bases de datos de usuario: puede usar el cmdlet para desconectar una base de datos o para volver a poner en línea una base de datos que esté deshabilitada.
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 Set-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 Set-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 Set-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 "Set-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 modificar. 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. |
Online |
Requerido |
Booleano |
Si está definido en True ($True), pone en línea una base de datos disponible. Si está definido en False ($False), desconecta una base de datos. |
RegistrarPool |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de registrador que hospeda la base de datos de usuario cuyo estado en línea se va a modificar. 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. |
Force |
Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando. |
||
WhatIf |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
||
Confirm |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Cadena de caracteres. Set-CsUserDatabaseState acepta un valor de cadena que representa la identidad de la base de datos de usuario que debe ser actualizada.
Tipos de valores devueltos
Ninguno. Set-CsUserDatabaseState modifica las instancias existentes del objeto Microsoft.Rtc.Management.Xds.UserStoreState.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com" -Online $False
El comando que se muestra en el Ejemplo 1 desconecta la base de datos de usuario UserDatabase:atl-sql-001.litwareinc.com. Para ello, la propiedad Online se define en $False.
-------------------------- Ejemplo 2 ------------------------
Set-CsUserDatabaseState -RegistrarPool atl-cs-001.litwareinc.com -Online $False
En el Ejemplo 2, se desconectan todas las bases de datos de usuario del grupo de registrador atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $False} | ForEach-Object {Set-CsUserDatabaseState -Identity $_.Identity -Online $True}
En el ejemplo anterior se localizan todas las bases de datos de usuario que están sin conexión y se vuelven a poner en línea. Para ello, el comando primero llama a Get-CsUserDatabaseState sin ningún parámetro para devolver una colección de todas las bases de datos de usuario de 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 False. A continuación, la colección filtrada se transfiere al cmdlet ForEach-Object, que establece el valor de la propiedad Online en True para todas las bases de datos de la colección. Tenga en cuenta que la colección de bases de datos sin conexión se debe transferir a ForEach-Object y no a Set-CsUserDatabaseState. Esto se debe a que el último cmdlet no puede aceptar directamente la información transferida.