Disable-CsUser
Tópico modificado em: 2012-03-23
Modifica a conta do Active Directory do usuário ou usuários especificados; esta modificação evita que os usuários utilizem clientes Microsoft Lync Server 2010 como o Microsoft Lync 2010. Disable-CsUser restringe apenas a atividade relacionada ao Lync Server 2010; ele não desabilita nem remove a conta de um usuário no Active Directory.
Sintaxe
Disable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O cmdlet Disable-CsUser exclui todas as informações do atributo relacionadas ao Lync Server de uma conta de usuário no Active Directory. Isso impede o usuário de fazer o logon no Lync Server. Quando se executa o cmdlet Disable-CsUser, todos os atributos relacionados ao Lync Server serão removidos de uma conta, inclusive as identidades ou quaisquer políticas por usuário que tiverem sido atribuídas a essa conta. É possível reabilitar posteriormente a conta, utilizando-se o cmdlet Enable-CsUser. Entretanto, todas as informações relacionadas a Lync Server (como atribuições de políticas) previamente associadas àquela conta deverão ser recriadas. Se deseja evitar que um usuário faça o logon no Lync Server, mas não quer perder todas as informações de sua conta, em vez disso, use Set-CsUser. Para obter mais detalhes, consulte o tópico da Ajuda Set-CsUser.
Depois que uma conta tiver sido desabilitada com o Disable-CsUser, o usuário afetado não será mais retornado pelo cmdlet Get-CsUser porque o usuário não possui mais uma conta do Lync Server válida. Para recuperar as informações da conta desabilitada do usuário, utilize Get-CsAdUser.
Além disso, os dados do usuário pertencentes à conta de usuário excluída serão removidos dos bancos de dados de backend. Por exemplo: o usuário será removido das listas de contatos na organização e quaisquer conferências agendadas por esse usuário serão excluídas.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Disable-CsUser localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsUser"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
UserIdParameter |
Indica a identidade da conta de usuário a ser desabilitada. As identidades de usuário podem ser especificadas usando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). Também é possível fazer referência a uma conta de usuário usando o nome diferenciado no Active Directory. É possível utilizar o caractere curinga asterisco (*) ao se utilizar o Nome de Exibição como Identidade de usuário. Por exemplo: a identidade "* Smith" retornará todos os usuários com nome de exibição que terminarem com o valor da cadeia de caracteres " Smith". |
DomainController |
Opcional |
Cadeia de caracteres |
Permite que você se conecte a um controlador de domínio especificado, para desabilitar a conta de um usuário. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome do computador (atl-cs-001, por exemplo) ou o seu nome de domínio totalmente qualificado (FQDN) (atl-cs-001.litwareinc.com, por exemplo). |
PassThru |
Opcional |
Parâmetro de opção |
Permite passar um objeto de usuário através do pipeline que representa a conta de usuário sendo desabilitada. Por padrão, o cmdlet Disable-CsUser não canaliza objetos. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Tipos de Entrada
Cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Disable-CsUser aceita um valor canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário que tenha sido habilitada para o Lync Server. O cmdlet também aceita instâncias canalizadas de objetos de usuário no Active Directory.
Tipos de Retorno
Disable-CsUser não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemplo
-------------------------- Exemplo 1 --------------------------
Disable-CsUser -Identity "Ken Myer"
O Exemplo anterior desabilita a conta do usuário Ken Myer no Lync Server. Neste exemplo, o nome de exibição do usuário é usado para indicar a sua identidade.
-------------------------- Exemplo 2 --------------------------
Get-CsUser -LDAPFilter "Department=Finance" | Disable-CsUser
No Exemplo 2, todas as contas de Lync Server dos usuários no departamento financeiro serão desabilitadas. Para executar esta tarefa, o comando primeiramente usa o cmdlet Get-CsUser e o parâmetro LDAPFilter, para retornar uma coleção de todos os usuários que pertencerem ao departamento Financeiro. Essa coleção é então canalizada para Disable-CsUser, que desabilita cada conta na coleção.
-------------------------- Exemplo 3 --------------------------
Get-CsUser -UnassignedUser | Disable-CsUser
No exemplo anterior, serão desabilitadas todas as contas de usuário não atribuídas a um pool de Registrador. Para fazer isso, o Get-CsUser é chamado, junto com o parâmetro UnassignedUser. Este parâmetro restringe os dados retornados a usuários que tiverem contas válidas, mas que não forem atribuídas a um pool de registrador. Essa coleção é então canalizada para Disable-CsUser, que desabilita cada conta na coleção.