Get-CsAdForest

 

Tópico modificado em: 2012-03-23

Retorna informações que indicam se a floresta do Active Directory foi configurada corretamente para permitir a instalação do Microsoft Lync Server 2010.

Sintaxe

Get-CsAdForest [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-SkipPrepareCheck <$true | $false>]

Descrição Detalhada

Antes de instalar o Lync Server 2010, é necessário realizar diversas alterações ao Serviços de Domínio Active Directory (AD DS) no nível de floresta. Isso inclui a criação de especificadores de exibição e objetos específicos do Lync Server, a criação de grupos de segurança universal que são necessários para gerenciar o Lync Server e a concessão de permissões de acesso a objetos de definições globais a esses grupos. O cmdlet Get-CsAdForest retorna um valor único, que informa se o Lync Server pode ou não ser instalado em uma floresta. Se Get-CsAdForest retornar o valor LC_FORESTSETTINGS_STATE_READY, será possível instalar o Lync Server na floresta. Se o cmdlet retornar LC_FORESTSETTINGS_STATE_NOT_READY, será necessário preparar corretamente a floresta antes de tentar instalar o Lync Server.

Get-CsAdForest é executado como parte do Assistente de instalação; se o Assistente determinar que a floresta não está preparada corretamente, será exibida uma mensagem de erro e a instalação será interrompida. No entanto, é possível executar Get-CsAdForest independentemente do Assistente de instalação, para verificar o status da floresta antes de se tentar instalar o Lync Server.

O Get-CsAdForest realiza a mesma função que o seguinte comando do Microsoft Office Communications Server 2007 R2:

Lcscmd.exe /forest /action:CheckForestPrepState

Quem pode executar esse cmdlet: Por padrão, qualquer pessoa que possua permissões de leitura do Active Directory pode executar o cmdlet Get-CsAdForest localmente. Normalmente, todos os membros do domínio possuem essa permissão.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdForest"}

Parâmetros

Parâmetro	Obrigatório	Digite	Descrição
GlobalCatalog	Opcional	Cadeia de caracteres	Nome de domínio totalmente qualificado (FQDN) de um servidor de catálogo global no domínio. Esse parâmetro não é necessário, se você estiver executando Get-CsAdForest em um computador com uma conta no 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 no AD DS, esse parâmetro deverá apontar para o controlador de domínio raiz. Se as definições globais estiverem armazenadas no contêiner Configuration, qualquer controlador de domínio poderá ser utilizado e este parâmetro poderá ser omitido.
RootDomainController	Opcional	Cadeia de caracteres	Nome de domínio totalmente qualificado do controlador de domínio raiz, utilizado para criar caminhos confiáveis a clientes que precisarem acessar recursos em domínios diferentes dos seus próprios.
Report	Opcional	Cadeia de caracteres	Permite especificar o caminho do arquivo de log criado quando o cmdlet for executado. Por exemplo: -Report "C:\Logs\ForestPrep.html"
SkipPrepareCheck	Opcional	Booliano	Quando definido como True ($True), faz com que o Get-CsAdForest seja executado sem fazer primeiro as verificações de preparação inicial.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsAdForest retorna instâncias do objeto Microsoft.Rtc.Management.Deployment.LcForestSettingsState.

Exemplo

-------------------------- Exemplo 1 --------------------------

Get-CsAdForest

O exemplo anterior retorna informações que indicam se a floresta do Active Directory foi configurada corretamente, para permitir a instalação do Lync Server.

-------------------------- Exemplo 2 --------------------------

Get-CsAdForest -Report C:\Logs\ForestState.html

No Exemplo 2, retornam-se informações de estado da floresta e exibe-se, na tela, a prontidão da floresta. Além disso, as informações detalhadas sobre as etapas tomadas para determinar o estado da floresta são gravadas em um arquivo denominado C:\Logs\ForestState.html. Esse arquivo inclui uma lista detalhada de todos os grupos e contêineres do Active Directory cujas permissões foram verificadas.