Get-CsAdDomain
Tópico modificado em: 2012-03-23
Retorna informações que indicam se o Serviços de Domínio Active Directory (AD DS) foi configurado corretamente para permitir a instalação do Microsoft Lync Server 2010.
Sintaxe
Get-CsAdDomain [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>]
Descrição Detalhada
Antes de instalar o Lync Server 2010, o seu domínio deve ser corretamente preparado, um processo que inclui a extensão do esquema do Active Directory, para permitir a adição de atributos específicos ao Lync Server e atribuir as Entradas de Controle de Acesso necessárias aos grupos universais usados para gerenciar e operar o Lync Server. O cmdlet Get-CsAdDomain retorna um valor único, que informa se o Lync Server pode ou não ser instalado em um domínio. Se Get-CsAdDomain retornar o valor LC_DOMAINSETTINGS_STATE_READY, é possível instalar o Lync Server nesse domínio. Se o cmdlet retornar LC_DOMAINSETTINGS_STATE_NOT_READY, será necessário preparar corretamente o domínio antes de tentar instalar o Lync Server.
Get-CsAdDomain é executado como parte do Assistente de Instalação. Se o Assistente determinar que o domínio não está corretamente preparado, será exibida uma mensagem de erro e a instalação será interrompida. No entanto, é possível executar Get-CsAdDomain independentemente do Assistente de Instalação para verificar o status do domínio antes de se tentar instalar o Lync Server.
Get-CsAdDomain realiza a mesma função que o seguinte comando do Microsoft Office Communications Server 2007 R2:
Lcscmd.exe /domain /action:CheckDomainPrepState
Quem pode executar esse cmdlet: Por padrão, qualquer usuário que possua permissões de leitura do Active Directory pode executar o cmdlet Get-CsAdDomain. Normalmente, todos os membros do domínio possuem essa permissão.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdDomain"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Domain |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) a ser verificado. Por exemplo: -Domain "litwareinc.com". Se esse parâmetro não for especificado, o domínio local será verificado. |
DomainController |
Opcional |
Cadeia de caracteres |
Permite que os administradores especifiquem o nome do domínio totalmente qualificado do controlador do domínio a ser usado ao se executar Get-CsAdDomain. Se não for especificado, o cmdlet usará o primeiro controlador de domínio disponível. |
GlobalCatalog |
Opcional |
Cadeia de caracteres |
FQDN de um servidor de catálogo global no seu domínio. Esse parâmetro não é necessário se você estiver executando Get-CsAdDomain em um computador com uma conta em seu domínio. |
GlobalSettingsDomainController |
Opcional |
Cadeia de caracteres |
FQDN de um controlador de domínio onde estão armazenadas as definições globais. Se as definições globais estiverem armazenadas no contêiner Sistema do Active Directory, este parâmetro deverá apontar para o controlador de domínio raiz. Se as definições globais estiverem armazenadas no contêiner Configuração, qualquer controlador de domínio poderá ser usado e esse parâmetro poderá ser omitido. |
Report |
Opcional |
Cadeia de caracteres |
Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\DomainPrep.html" |
Tipos de Entrada
Nenhuma. Get-CsAdDomain não aceita a entrada canalizada.
Tipos de Retorno
Get-CsAdDomain retorna instâncias do objeto Microsoft.Rtc.Management.Deployment.LcDomainSettingsState.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsAdDomain
O exemplo anterior retorna informações a respeito do status atual do domínio local do Active Directory. Se suas definições do domínio estiverem atualizadas e o domínio estiver pronto para hospedar o Lync Server 2010, será retornado o valor LC_DOMAIN_SETTINGS_STATE_READY.
-------------------------- Exemplo 2 --------------------------
Get-CsAdDomain -Domain "fabrikam.com"
O comando exibido no Exemplo 2 retorna o status de um domínio específico: fabrikam.com. Em um ambiente de diversos domínios, é possível retornar informações sobre um determinado domínio, incluindo-se o parâmetro Domínio.
-------------------------- Exemplo 3 --------------------------
Get-CsAdDomain -Report "C:\Logs\DomainReport.html"
O Exemplo 3 recupera o status atual do domínio do Active Directory e, ao mesmo tempo, grava informações sobre o status em um arquivo denominado C:\Logs\DomainReport.html. Esse arquivo detalhará as etapas realizadas pelo Get-CsAdDomain, para determinar o status de prontidão do domínio. Essas etapas incluem tarefas como a verificação da existência de grupos do Active Directory e a verificação de definições de permissão em vários contêineres do Active Directory.