Get-DomainController

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-DomainController para exibir uma lista de controladores de domínio que há em sua organização.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-DomainController
   [-GlobalCatalog]
   [-Forest <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Get-DomainController
   [-DomainName <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Description

O cmdlet Get-DomainController é usado pelo centro de administração do Exchange para preencher campos que exibem informações do controlador de domínio.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

$UserCredentials = Get-Credential

Get-DomainController -DomainName corp.contoso.com -Credential $UserCredentials | Format-Table -AutoSize Name,ADSite

Este exemplo recupera uma lista de servidores de catálogo global do domínio corp.contoso.com. Como um conjunto diferente de credenciais é necessário para acessar esse domínio, o cmdlet Get-Credential é usado para obter o nome de usuário e a senha do usuário.

O primeiro comando exibe um prompt para o usuário que aceita o nome de usuário e a senha. As credenciais são então armazenadas na variável $UserCredentials. O segundo comando usa a variável $UserCredentials para o valor do parâmetro credential. Para tornar a lista mais legível, a saída é canalizada para o cmdlet Format-Table e apenas as propriedades Name e ADSite são exibidas.

Para obter mais informações sobre pipelining e o cmdlet Format-Table, consulte Sobre Pipelines e Trabalhando com saída de comando.

Parâmetros

-Credential

O parâmetro Credential especifica o nome de usuário e a senha usados para executar esse comando. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias.

Esse parâmetro exige a criação e a passagem de um objeto de credencial. Esse objeto de credencial é criado com o cmdlet Get-Credential. Para saber mais, confira Obter credencial.

Se você usar o parâmetro Forest, as credenciais serão usadas para acessar a floresta.

Type:	NetworkCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainName

O parâmetro DomainName especifica o nome de domínio totalmente qualificado (FQDN) do domínio para o qual você deseja retornar uma lista de controladores de domínio.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Forest

O parâmetro Forest especifica o FQDN do domínio raiz da floresta para o qual você deseja retornar uma lista de controladores de domínio.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GlobalCatalog

A opção GlobalCatalog especifica se o comando deve retornar uma lista de servidores de catálogo global. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.