Get-CsUserDatabaseState
Tópico modificado em: 2012-03-23
Retorna informações sobre o status online (True ou False) de um ou vários bancos de dados do usuário do Microsoft Lync Server 2010.
Sintaxe
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
Descrição Detalhada
O Lync Server 2010 emprega o banco de dados de usuários (também conhecido como repositório de usuários) para manter as informações de presença e roteamento de usuários do Lync Server. O cmdlet Get-CsUserDatabaseState permite verificar o status (online ou offline) de qualquer banco de dados de usuários que estiver em uso na organização.
Observe que, por padrão, não se habilitam as exceções de firewall do SQL Server Express ao se instalar a Standard Edition do Lync Server 2010. Por sua vez, isso significa que não será possível executar Get-CsUserDatabaseState em uma instância remota do Windows PowerShell. Isso ocorre porque o comando não poderá atravessar o firewall e acessar o banco de dados do SQL Server Express. Você ainda poderá executar o cmdlet localmente (ou seja, no próprio servidor Standard Edition). No entanto, para executar Get-CsUserDatabaseState remotamente, será necessário habilitar manualmente as exceções do firewall para o SQL Server Express.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsUserDatabaseState localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserDatabaseState"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
Identificador exclusivo do banco de dados de usuários cujo status online deve ser retornado. Por exemplo: -Identity "UserDatabase:atl-sql-001.litwareinc.com". Não é possível usar Identity e RegistrarPool no mesmo comando, nem usar curingas com os parâmetros. Se ambos os parâmetros forem omitidos, Get-CsUserDatabaseState retornará informações sobre todos os bancos de dados de usuários que estiverem em uso. |
RegistrarPool |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado do pool do Registrador que hospeda os bancos de dados de usuários cujo status online deve ser retornado. Por exemplo: -RegistrarPool "atl-cs-001.litwareinc.com". Não é possível usar Identity e RegistrarPool no mesmo comando, nem usar curingas com os parâmetros. Se ambos os parâmetros forem omitidos, Get-CsUserDatabaseState retornará informações sobre todos os bancos de dados de usuários que estiverem em uso. |
Tipos de Entrada
Nenhuma. Get-CsUserDatabaseState não aceita a entrada canalizada.
Tipos de Retorno
Get-CsUserDatabaseState retorna instâncias do objeto Microsoft.Rtc.Management.Xds.UserStoreState.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsUserDatabaseState
O comando exibido no Exemplo 1 retorna o status online de cada banco de dados de usuários para uso na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
O comando exibido no Exemplo 2 retorna o status online de um único banco de dados de usuários: o banco de dados com a Identidade UserDatabase:atl-sql-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
No Exemplo 3, são retornadas informações de status de todos os bancos de dados de usuários localizados no pool de registradores atl-cs-001.litwareinc.com.
-------------------------- Exemplo 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
No exemplo anterior, são retornadas informações de todos os bancos de dados de usuários que estiverem online. Para fazer isso, o comando primeiramente chama Get-CsUserDatabaseState sem qualquer parâmetro. Isso retorna uma coleção de todos os bancos de dados de usuários em uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os bancos de dados cuja propriedade Online for igual a True.