Get-DomainController

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Этот командлет доступен только в локальной среде Exchange.

Используйте командлет Get-DomainController для просмотра списка контроллеров домена, существующих в организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

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

Описание

Командлет Get-DomainController используется Центром администрирования Exchange для заполнения полей, отображающих сведения о контроллере домена.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

$UserCredentials = Get-Credential

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

В этом примере выполняется получение списка глобальных серверов каталога в домене corp.contoso.com. Так как для доступа к этому домену требуется другой набор учетных данных, командлет Get-Credential используется для получения имени пользователя и пароля.

Первая команда отображает запрос для пользователя, который принимает имя пользователя и пароль. Затем учетные данные хранятся в переменной $UserCredentials. Вторая команда использует переменную $UserCredentials для значения параметра Credential. Чтобы сделать список более удобочитаемым, выходные данные передаются в командлет Format-Table и отображаются только свойства Name и ADSite.

Дополнительные сведения о конвейерной работе и командлете Format-Table см. в разделах Сведения о конвейерах и Работа с выходными данными команд.

Параметры

-Credential

Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для этого параметра необходимо создавать и передавать объект учетных данных. Этот объект создается с помощью командлета Get-Credential. Для получения дополнительной информации см. Get-Credential.

Если используется параметр Forest, учетные данные используются для доступа к лесу.

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

Параметр DomainName указывает полное доменное имя (FQDN) домена, для которого требуется вернуть список контроллеров домена.

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

Параметр Forest указывает полное доменное имя корневого домена леса, для которого требуется вернуть список контроллеров домена.

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

Параметр GlobalCatalog указывает, должна ли команда возвращать список серверов глобального каталога. Указывать значение для этого параметра необязательно.

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

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.