Revoke-CsSetupPermission
Tópico modificado em: 2012-03-27
Revoga os direitos de instalação do Microsoft Lync Server 2010 que tiverem sido concedidos em uma unidade organizacional (OU) do Active Directory.
Sintaxe
Revoke-CsSetupPermission -ComputerOu <String> [-Confirm [<SwitchParameter>]] [-Domain <Fqdn>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
A preparação do domínio que acontece quando se instala o Lync Server 2010 não adiciona automaticamente os direitos que habilitam os membros do grupo RTCUniversalServerAdmins a executar o cmdlet Enable-CsTopology. Isso significa que, por padrão, é necessário que você seja um administrador do domínio para poder habilitar uma topologia. Para conceder aos membros do grupo RTCUniversalServerAdmins o direito de habilitar uma topologia, você deve executar o cmdlet Grant-CsSetupPermissions. Além disso, será necessário executar este cmdlet em cada contêiner do Active Directory que hospedar computadores que estiverem executando o Lync Server.
Os direitos concedidos mediante o uso de Grant-CsSetupPermission podem ser removidos posteriormente usando Revoke-CsSetupPermission. Se esse cmdlet for executado, o grupo RTCUniversalServerAdmins não terá mais direitos para instalar o Lync Server no contêiner especificado do Active Directory. Neste caso, será necessário ser um administrador corporativo ou um administrador de domínios para poder habilitar uma topologia do Lync Server.
Quem pode executar este cmdlet: É necessário que você seja um administrador de domínio para poder executar o cmdlet Revoke-CsSetupPermission localmente. 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 "Revoke-CsSetupPermission"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ComputerOU |
Obrigatório |
Direito do Active Directory |
O nome diferenciado (DN) da OU que contém as contas dos computadores nos quais o Lync Server será (ou foi) instalado. Por exemplo: -ComputerOU "ou=CsServers,dc=litwareinc,dc=com". Se preferir, a parte de domínio do nome diferenciado pode ser omitida ao se especificar a OU. Por exemplo: -ComputerOU "ou=CsServers" |
Domain |
Opcional |
Cadeia de caracteres |
Nome do domínio onde está localizada a OU. Se este parâmetro não for incluído, Revoke-CsSetupPermission procurará a OU no domínio atual. |
DomainController |
Opcional |
Cadeia de caracteres |
Nome totalmente qualificado do controlador de domínio a ser contatado ao se atribuir a política. Por exemplo: -DomainController atl-dc-001.litwareinc.com. Se não for especificado, ao atribuir a política, Revoke-CsSetupPermission contatará o controlador de domínio disponível mais próximo. |
GlobalCatalog |
Opcional |
Cadeia de caracteres |
Nome totalmente qualificado do servidor de catálogo global a ser contatado ao se atribuir a política. Por exemplo: -GlobalCatalog atl-dc-001.litwareinc.com. Se não for especificado, ao atribuir a política, Revoke-CsSetupPermission contatará o servidor de catálogo global disponível mais próximo. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Report |
Opcional |
Cadeia de caracteres |
Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\OUPermissions.html" |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Revoke-CsSetupPermission não aceita entradas canalizadas.
Tipos de Retorno
Nenhuma.
Exemplo
-------------------------- Exemplo 1 ------------------------
Revoke-CsSetupPermission -ComputerOU "ou=CsServers,dc=litwareinc,dc=com"
O comando apresentado no Exemplo 1 revoga os direitos de instalação aplicados à OU CsServers no domínio litwareinc.com.