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

Microsoft Entra Connect: справочник по модулю PowerShell ADConnectivityTools

  • Статья

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

Confirm-DnsConnectivity

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

Пример 2

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

PARAMETERS

-Forest

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

PARAMETERS

-Forest

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

Краткий обзор

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

SYNTAX

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

PARAMETERS

-Forest

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-NetworkConnectivity

Краткий обзор

Выявляет наличие проблем с локальным сетевым подключением.

SYNTAX

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

ОПИСАНИЕ

Выполняет проверку локального сетевого подключения.

Для локальных сетевых тестов Microsoft Entra Подключение должны иметь возможность взаимодействовать с именованными контроллерами домена на портах 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

PARAMETERS

-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 или входом DC, то ему или ей может потребоваться пропустить проверку порта 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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

Пример 2

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

PARAMETERS

-Forest

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

Краткий обзор

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

SYNTAX

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

PARAMETERS

-Forest

Целевой лес.

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterpriseAdminCredentials

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

Пример 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

Пример 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

Пример 2

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

PARAMETERS

-Forest

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-ConnectivityValidation

Краткий обзор

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

SYNTAX

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

ОПИСАНИЕ

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

Примеры

Пример 1

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

PARAMETERS

-Forest

Целевой лес.

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 Подключение. Имеет значение $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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-NetworkConnectivityDiagnosisTools

Краткий обзор

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

SYNTAX

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"

PARAMETERS

-Forest

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

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

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. Дополнительные сведения см. в статье Об общих параметрах (https://go.microsoft.com/fwlink/?LinkID=113216).