Get-DomainController
Этот командлет доступен только в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.