Test-CsSetupPermission
Tópico modificado em: 2012-03-26
Certifica-se de que as permissões necessárias requeridas para instalar o Microsoft Lync Server 2010 ou um de seus componentes tenham sido configuradas no contêiner Active Directory especificado.
Sintaxe
Test-CsSetupPermission -ComputerOU <String> [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-Report <String>]
Descrição Detalhada
O preparo do domínio que ocorre ao instalar Lync Server 2010 não adiciona automaticamente as permissões que permitem que membros do grupo RTCUniversalServerAdmins executem o cmdlet Enable-CsTopology. Isso significa que, por padrão, é necessário ser um administrador de domínio para habilitar uma topologia. Para conceder aos membros do grupo RTCUniversalServerAdmins o direito de habilitar uma topologia, é necessário executar o cmdlet Grant-CsSetupPermissions. Além disso, será necessário executar esse cmdlet em cada contêiner do Active Directory que hospede computadores que executam Lync Server.
O cmdlet Test-CsSetupPermission permite determinar se permissões necessárias foram adicionadas ou não a um determinado contêiner Active Directory (ou seja, um contêiner que hospeda computadores que estiverem executando o Lync Server). Test-CsSetupPermission retorna True, se as permissões corretas tiverem sido aplicadas, e False, se não tiverem. Se o cmdlet retornar False, será necessário executar Grant-CsSetupPermission para realizar as alterações necessárias no contêiner Active Directory.
Quem pode executar esse cmdlet: 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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsSetupPermission"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ComputerOU |
Obrigatório |
Nome diferenciado do Active Directory |
Nome diferenciado da unidade organizacional (OU) que contenha as contas para o computador que executa Lync Server. Por exemplo: "ou=CsServers,dc=litwareinc,dc=com". |
Domain |
Opcional |
Cadeia de caracteres |
Nome do domínio onde está localizado o OU a ser verificado. Se este parâmetro não for incluído, então Test-CsSetupPermission procurará a OU no domínio atual. |
DomainController |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) de um controlador de domínio em seu domínio. Este parâmetro não será necessário se Test-CsSetupPermission estiver sendo executado em um computador com uma conta no domínio. |
GlobalCatalog |
Opcional |
Cadeia de caracteres |
FQDN de um servidor de catálogo global em seu domínio. Este parâmetro não será necessário se Test-CsSetupPermission estiver sendo executado em um computador com uma conta no domínio. |
Report |
Opcional |
Cadeia de caracteres |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Verbose |
Opcional |
Parâmetro de opção |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma. Test-CsSetupPermission não aceita a entrada em pipeline.
Tipos de Retorno
Test-CsSetupPermission retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 ------------------------
Test-CsSetupPermission -ComputerOU "ou=CsServers,dc=litwareinc,dc=com"
O comando apresentado no Exemplo 1 verifica se as permissões de instalação necessárias foram aplicadas ao OU CsServers, no litwareinc.com domain.