Поделиться через

Microsoft Entra Connect: ADConnectivityTools PowerShell Reference

  • Статья

В следующей документации приведены справочные сведения для модуля PowerShell ADConnectivityTools, включенного в Microsoft Entra Connect в C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-DnsConnectivity

СИНОПСИС

Обнаруживает локальные проблемы DNS.

СИНТАКСИС

Confirm-DnsConnectivity [-Forest] <String> [-DCs] <Array> [-ReturnResultAsPSObject] [<CommonParameters>]

ОПИСАНИЕ

Выполняет локальные тесты подключения Dns. Чтобы настроить соединитель Active Directory, сервер Microsoft Entra Connect должен иметь разрешение имен для леса, к которому он пытается подключиться, а также к контроллерам домена, связанным с этим лесом.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-DnsConnectivity -Forest "TEST.CONTOSO.COM" -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

ПРИМЕР 2

Confirm-DnsConnectivity -Forest "TEST.CONTOSO.COM"

ПАРАМЕТРЫ

-Лес

Указывает имя леса для проверки.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DCs

Укажите контроллеры домена для тестирования.

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

Возвращает результат этого диагноза в виде PSObject. Не требуется во время ручного взаимодействия с этим средством.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

СИНОПСИС

Определяет, существует ли указанный лес.

СИНТАКСИС

Confirm-ForestExists [-Forest] <String> [<CommonParameters>]

ОПИСАНИЕ

Запрашивает DNS-сервер для IP-адресов, связанных с лесом.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM"

ПАРАМЕТРЫ

-Лес

Указывает имя леса для проверки.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

СИНОПСИС

Проверяет функциональный уровень леса AD.

СИНТАКСИС

SamAccount

Confirm-FunctionalLevel -Forest <String> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ForestFQDN

Confirm-FunctionalLevel -ForestFQDN <Forest> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ОПИСАНИЕ

Проверяет, равен ли функциональный уровень леса AD или больше заданного minAdForestVersion (WindowsServer2003). Можно запросить учетную запись (домен\имя пользователя) и пароль.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-FunctionalLevel -Forest "test.contoso.com"

ПРИМЕР 2

Confirm-FunctionalLevel -Forest "test.contoso.com" -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПРИМЕР 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПАРАМЕТРЫ

-Лес

Целевой лес. Значение по умолчанию — лес текущего пользователя, вошедшего в систему.

Type: String
Parameter Sets: SamAccount
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForestFQDN

Целевой объект ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

Функция будет использовать учетные данные пользователя, вошедшего в систему на компьютере, а не запрашивать пользовательские учетные данные от пользователя.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-NetworkConnectivity

СИНОПСИС

Обнаруживает проблемы с подключением к локальной сети.

СИНТАКСИС

Confirm-NetworkConnectivity [-DCs] <Array> [-SkipDnsPort] [-ReturnResultAsPSObject] [<CommonParameters>]

ОПИСАНИЕ

Выполняет тесты подключения к локальной сети.

Для локальных сетевых тестов Microsoft Entra Connect должен иметь возможность взаимодействовать с именованными контроллерами домена на портах 53 (DNS), 88 (Kerberos) и 389 (LDAP) Большинство организаций выполняют DNS на своих контроллерах домена, поэтому этот тест в настоящее время интегрирован. Порт 53 следует пропустить, если был указан другой DNS-сервер.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-NetworkConnectivity -SkipDnsPort -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

ПРИМЕР 2

Confirm-NetworkConnectivity -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM" -Verbose

ПАРАМЕТРЫ

-DCs

Укажите контроллеры домена для тестирования.

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SkipDnsPort

Если пользователь не использует службы DNS, предоставляемые доменом домена AD или входом в систему, может потребоваться пропустить проверку порта 53. Пользователь по-прежнему должен иметь возможность разрешать _.ldap._tcp.<forestfqdn> для успешной настройки соединителя Active Directory.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

Возвращает результат этого диагноза в виде PSObject. Не требуется во время ручного взаимодействия с этим средством.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

СИНОПСИС

Определяет, доступен ли указанный лес и связанные с ним контроллеры домена.

СИНТАКСИС

Confirm-TargetsAreReachable [-Forest] <String> [-DCs] <Array> [<CommonParameters>]

ОПИСАНИЕ

Выполняет тесты "ping" (может ли компьютер получить доступ к целевому компьютеру через сеть и (или) Интернет)

ПРИМЕРЫ

ПРИМЕР 1

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM" -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

ПРИМЕР 2

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM"

ПАРАМЕТРЫ

-Лес

Указывает имя леса для проверки.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DCs

Укажите контроллеры домена для тестирования.

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

СИНОПСИС

Убедитесь, что домены в полученном полное доменное имя леса доступны

СИНТАКСИС

SamAccount

Confirm-ValidDomains [-Forest <String>] [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ForestFQDN

Confirm-ValidDomains -ForestFQDN <Forest> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ОПИСАНИЕ

Убедитесь, что все домены в полученном полное доменное имя леса доступны, пытаясь получить DomainGuid и DomainDN. Можно запросить учетную запись (домен\имя пользователя) и пароль.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-ValidDomains -Forest "test.contoso.com" -Verbose

ПРИМЕР 2

Confirm-ValidDomains -Forest "test.contoso.com" -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПРИМЕР 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПАРАМЕТРЫ

-Лес

Целевой лес.

Type: String
Parameter Sets: SamAccount
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForestFQDN

Целевой объект ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

Функция будет использовать учетные данные пользователя, вошедшего в систему на компьютере, а не запрашивать пользовательские учетные данные от пользователя.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterpriseAdminCredentials

СИНОПСИС

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

СИНТАКСИС

Confirm-ValidEnterpriseAdminCredentials [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ОПИСАНИЕ

Выполняет поиск, если у пользователя есть учетные данные администратора предприятия. Можно запросить учетную запись (домен\имя пользователя) и пароль.

ПРИМЕРЫ

ПРИМЕР 1

Confirm-ValidEnterpriseAdminCredentials -DomainName test.contoso.com -Verbose

ПРИМЕР 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПАРАМЕТРЫ

-RunWithCurrentlyLoggedInUserCredentials

Функция будет использовать учетные данные пользователя, вошедшего в систему на компьютере, а не запрашивать пользовательские учетные данные от пользователя.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

СИНОПСИС

Извлекает доменное имя из учетной записи и сочетания паролей.

СИНТАКСИС

Get-DomainFQDNData [[-DomainFQDNDataType] <String>] [-RunWithCurrentlyLoggedInUserCredentials]
 [-ReturnExceptionOnError] [<CommonParameters>]

ОПИСАНИЕ

Пытается получить объект domainFQDN из предоставленных учетных данных. Если доменFQDN действителен, возвращается имя домена или rootDomainName в зависимости от выбора пользователя. Можно запросить учетную запись (домен\имя пользователя) и пароль.

ПРИМЕРЫ

ПРИМЕР 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

ПРИМЕР 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

ПАРАМЕТРЫ

-DomainFQDNDataType

Требуемый тип данных, которые будут получены. В настоящее время ограничено значением DomainFQDNName или RootDomainName.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

Функция будет использовать учетные данные пользователя, вошедшего в систему на компьютере, а не запрашивать пользовательские учетные данные от пользователя.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnExceptionOnError

Вспомогательный параметр, используемый функцией Start-NetworkConnectivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

СИНОПСИС

Извлекает имя ForestFQDN из сочетания учетных записей и паролей.

СИНТАКСИС

Get-ForestFQDN [-Forest] <String> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ОПИСАНИЕ

Пытается получить имя ForestFQDN из предоставленных учетных данных. Можно запросить учетную запись (домен\имя пользователя) и пароль.

ПРИМЕРЫ

ПРИМЕР 1

Get-ForestFQDN -Forest CONTOSO.MICROSOFT.COM -Verbose

ПРИМЕР 2

Get-ForestFQDN -Forest CONTOSO.MICROSOFT.COM -RunWithCurrentlyLoggedInUserCredentials -Verbose

ПАРАМЕТРЫ

-Лес

Целевой лес. Значение по умолчанию — это домен пользователя, вошедшего в систему.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

Функция будет использовать учетные данные пользователя, вошедшего в систему на компьютере, а не запрашивать пользовательские учетные данные от пользователя.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-ConnectivityValidation

СИНОПСИС

Основная функция.

СИНТАКСИС

Start-ConnectivityValidation [-Forest] <String> [-AutoCreateConnectorAccount] <Boolean> [[-UserName] <String>]
 [<CommonParameters>]

ОПИСАНИЕ

Выполняет все доступные механизмы проверки допустимости учетных данных AD.

ПРИМЕРЫ

ПРИМЕР 1

Start-ConnectivityValidation -Forest "test.contoso.com" -AutoCreateConnectorAccount $True -Verbose

ПАРАМЕТРЫ

-Лес

Целевой лес.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AutoCreateConnectorAccount

Для пользовательских установок: флаг, $True, если пользователь выбрал "Создать учетную запись AD" в окне учетной записи леса AD мастера Microsoft Entra Connect. $False, если пользователь выбрал "Использовать существующую учетную запись AD". Для экспресс-установки: значение этой переменной должно быть $True для экспресс-установки.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-UserName

Параметр, который предварительно заполняет поле имени пользователя при запросе учетных данных пользователя.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-NetworkConnectivityDiagnosisTools

СИНОПСИС

Основная функция для тестов сетевого подключения.

СИНТАКСИС

Start-NetworkConnectivityDiagnosisTools [[-Forest] <String>] [-Credentials] <PSCredential>
 [[-LogFileLocation] <String>] [[-DCs] <Array>] [-DisplayInformativeMessage] [-ReturnResultAsPSObject]
 [-ValidCredentials] [<CommonParameters>]

ОПИСАНИЕ

Выполняет тесты подключения к локальной сети.

ПРИМЕРЫ

ПРИМЕР 1

Start-NetworkConnectivityDiagnosisTools -Forest "TEST.CONTOSO.COM"

ПРИМЕР 2

Start-NetworkConnectivityDiagnosisTools -Forest "TEST.CONTOSO.COM" -DCs "DC1.TEST.CONTOSO.COM", "DC2.TEST.CONTOSO.COM"

ПАРАМЕТРЫ

-Лес

Указывает имя леса для проверки.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Верительные грамоты

Имя пользователя и пароль пользователя, выполняющего тест. Для этого требуется тот же уровень разрешений, который требуется для запуска мастера Microsoft Entra Connect.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LogFileLocation

Указывает расположение файла журнала, содержащего выходные данные этой функции.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DCs

Укажите контроллеры домена для тестирования.

Type: Array
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisplayInformativeMessage

Флаг, позволяющий отображать сообщение о назначении этой функции.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

Возвращает результат этого диагноза в виде PSObject. Не обязательно указывать во время ручного взаимодействия с этим средством.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ValidCredentials

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).