Set-CsUserDatabaseState
Tópico modificado em: 2012-03-27
Habilita (ou desabilita) um ou vários bancos de dados de usuários do Microsoft Lync Server 2010.
Sintaxe
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>]]
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 Set-CsUserDatabaseState permite alterar o estado de um ou vários bancos de dados de usuários: é possível usar o cmdlet para retirar de linha um banco de dados ou recolocar um banco de dados desabilitado online.
Observe que, por padrão, as exceções de firewall do SQL Server Express não são habilitadas ao se instalar a Standard Edition do Lync Server 2010. Por sua vez, isso significa que não será possível executar Set-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 Set-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 Set-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 "Set-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 modificado. 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. |
Online |
Obrigatório |
Booleano |
Quando for definido como True ($True), disponibiliza um banco de dados online. Quando for definido como False ($False), coloca um banco de dados offline. |
RegistrarPool |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) do pool do Registrador que hospeda os bancos de dados de usuários cujo status online deve ser modificado. 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. |
Force |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir durante a execução do comando. |
||
WhatIf |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
||
Confirm |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Cadeia de caracteres. Set-CsUserDatabaseState aceita um valor de cadeia de caracteres que representa a Identidade do banco de dados de usuários que deve ser atualizado.
Tipos de Retorno
Nenhuma. Em vez disso, o Set-CsUserDatabaseState modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.UserStoreState.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com" -Online $False
O comando exibido no Exemplo 1 coloca offline o banco de dados de usuários UserDatabase:atl-sql-001.litwareinc.com. Isso é feito definindo-se a propriedade Online como sendo $False.
-------------------------- Exemplo 2 ------------------------
Set-CsUserDatabaseState -RegistrarPool atl-cs-001.litwareinc.com -Online $False
No Exemplo 2, são colocados offline todos os bancos de dados de usuários no pool do Registrador atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $False} | ForEach-Object {Set-CsUserDatabaseState -Identity $_.Identity -Online $True}
O exemplo anterior localiza todos os bancos de dados de usuários que estiverem offline e os recoloca online. Para fazer isso, o comando primeiramente chama Get-CsUserDatabaseState, sem qualquer parâmetro, para retornar uma coleção de todos os bancos de dados de usuários 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 False. Esta coleção filtrada será então canalizada para o cmdlet ForEach-Object, que selecionará cada banco de dados na coleção e definirá a propriedade Online como True. Observe que a coleção de bancos de dados offline deve ser canalizada para ForEach-Object, em vez de Set-CsUserDatabaseState. Isso porque o último cmdlet não pode aceitar diretamente informações canalizadas.