Udostępnij za pośrednictwem

Microsoft Entra Connect: ADConnectivityTools — dokumentacja programu PowerShell

  • Artykuł

Poniższa dokumentacja zawiera informacje referencyjne dotyczące modułu programu PowerShell dołączonego ADConnectivityTools do usługi Microsoft Entra Połączenie w programie C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Potwierdzanie dns Połączenie ivity

STRESZCZENIE

Wykrywa lokalne problemy z systemem DNS.

SKŁADNIA

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

OPIS

Uruchamia lokalne testy łączności DNS. Aby skonfigurować łącznik usługi Active Directory, serwer Microsoft Entra Połączenie musi mieć zarówno rozpoznawanie nazw lasu, z którymi próbuje nawiązać połączenie, jak i z kontrolerami domeny skojarzonymi z tym lasem.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PARAMETRY

-Lasu

Określa nazwę lasu do przetestowania.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Określ kontrolery domeny do przetestowania.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Zwraca wynik tej diagnozy w postaci obiektu PSObject. Nie jest to konieczne podczas ręcznej interakcji z tym narzędziem.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

STRESZCZENIE

Określa, czy istnieje określony las.

SKŁADNIA

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

OPIS

Wysyła zapytanie do serwera DNS dla adresów IP skojarzonych z lasem.

PRZYKŁADY

PRZYKŁAD 1

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

PARAMETRY

-Lasu

Określa nazwę lasu do przetestowania.

Type: String
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

STRESZCZENIE

Sprawdza poziom funkcjonalności lasu usługi AD.

SKŁADNIA

SamAccount

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

ForestFQDN

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

OPIS

Sprawdza, czy poziom funkcjonalności lasu usługi AD jest równy lub większy niż określony parametr MinAdForestVersion (WindowsServer2003). Może być wymagane konto (domena\nazwa użytkownika) i hasło.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PRZYKŁAD 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-Lasu

Las docelowy. Wartość domyślna to Las aktualnie zalogowanego użytkownika.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Docelowy obiekt ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkcja będzie używać poświadczeń użytkownika, który jest obecnie zalogowany na komputerze, zamiast żądać poświadczeń niestandardowych od użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Potwierdzanie sieci Połączenie ivity

STRESZCZENIE

Wykrywa problemy z łącznością sieci lokalnej.

SKŁADNIA

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

OPIS

Uruchamia lokalne testy łączności sieciowej.

W przypadku testów sieci lokalnej firma Microsoft Entra Połączenie musi mieć możliwość komunikowania się z nazwanymi kontrolerami domeny na portach 53 (DNS), 88 (Kerberos) i 389 (LDAP) Większość organizacji uruchamia system DNS na swoich kontrolerach domeny, dlatego ten test jest obecnie zintegrowany. Jeśli określono inny serwer DNS, należy pominąć port 53.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PARAMETRY

-Dcs

Określ kontrolery domeny do przetestowania.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Jeśli użytkownik nie korzysta z usług DNS udostępnianych przez witrynę usługi AD / kontroler domeny logowania, może chcieć pominąć sprawdzanie portu 53. Użytkownik musi nadal mieć możliwość rozwiązania _.ldap._tcp.<forestfqdn> w celu pomyślnego wykonania konfiguracji Połączenie or usługi Active Directory.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Zwraca wynik tej diagnozy w postaci obiektu PSObject. Nie jest to konieczne podczas ręcznej interakcji z tym narzędziem.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

STRESZCZENIE

Określa, czy określony las i skojarzone z nim kontrolery domeny są osiągalne.

SKŁADNIA

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

OPIS

Uruchamia testy "ping" (czy komputer może dotrzeć do komputera docelowego za pośrednictwem sieci i/lub Internetu)

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PARAMETRY

-Lasu

Określa nazwę lasu do przetestowania.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Określ kontrolery domeny do przetestowania.

Type: Array
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

STRESZCZENIE

Sprawdź, czy domeny w uzyskanej nazwie FQDN lasu są osiągalne

SKŁADNIA

SamAccount

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

ForestFQDN

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

OPIS

Sprawdź, czy wszystkie domeny w uzyskanej nazwie FQDN lasu są osiągalne, próbując pobrać domenę DomainGuid i domainDN. Może być wymagane konto (domena\nazwa użytkownika) i hasło.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PRZYKŁAD 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-Lasu

Las docelowy.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Docelowy obiekt ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkcja będzie używać poświadczeń użytkownika, który jest obecnie zalogowany na komputerze, zamiast żądać poświadczeń niestandardowych od użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterprise Administracja Credentials

STRESZCZENIE

Sprawdza, czy użytkownik ma poświadczenia Administracja Enterprise.

SKŁADNIA

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

OPIS

Wyszukuje, jeśli podany użytkownik ma poświadczenia Administracja Enterprise. Może być wymagane konto (domena\nazwa użytkownika) i hasło.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-RunWithCurrentlyLoggedInUserCredentials

Funkcja będzie używać poświadczeń użytkownika, który jest obecnie zalogowany na komputerze, zamiast żądać poświadczeń niestandardowych od użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

STRESZCZENIE

Pobiera nazwę DomainFQDN z konta i kombinacji hasła.

SKŁADNIA

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

OPIS

Próbuje uzyskać obiekt domainFQDN poza podanymi poświadczeniami. Jeśli nazwa domenyFQDN jest prawidłowa, zostanie zwrócona nazwa DomenyFQDN lub nazwa RootDomainName, w zależności od wyboru użytkownika. Może być wymagane konto (domena\nazwa użytkownika) i hasło.

PRZYKŁADY

PRZYKŁAD 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

PRZYKŁAD 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETRY

-DomainFQDNDataType

Żądany rodzaj danych, które zostaną pobrane. Obecnie ograniczone do "DomainFQDNName" lub "RootDomainName".

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkcja będzie używać poświadczeń użytkownika, który jest obecnie zalogowany na komputerze, zamiast żądać poświadczeń niestandardowych od użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Parametr pomocniczy używany przez funkcję Start-Network Połączenie ivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

STRESZCZENIE

Pobiera nazwę ForestFQDN z konta i kombinacji hasła.

SKŁADNIA

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

OPIS

Próbuje uzyskać nazwę ForestFQDN z podanych poświadczeń. Może być wymagane konto (domena\nazwa użytkownika) i hasło.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PARAMETRY

-Lasu

Las docelowy. Wartość domyślna to domena aktualnie zalogowanego użytkownika.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkcja będzie używać poświadczeń użytkownika, który jest obecnie zalogowany na komputerze, zamiast żądać poświadczeń niestandardowych od użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Początkowa Połączenie ivityValidation

STRESZCZENIE

Funkcja Main.

SKŁADNIA

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

OPIS

Uruchamia wszystkie dostępne mechanizmy sprawdzające, czy poświadczenia usługi AD są prawidłowe.

PRZYKŁADY

PRZYKŁAD 1

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

PARAMETRY

-Lasu

Las docelowy.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoTworzenie Połączenie orAccount

W przypadku instalacji niestandardowych: flaga $True, jeśli użytkownik wybrał pozycję "Utwórz nowe konto usługi AD" w oknie Konto lasu usługi AD kreatora usługi Microsoft Entra Połączenie. $False, jeśli użytkownik wybrał pozycję "Użyj istniejącego konta usługi AD". W przypadku instalacji ekspresowych: wartość tej zmiennej musi być $True dla instalacji ekspresowych.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Nazwę użytkownika

Parametr, który wstępnie wypełnia pole Nazwa użytkownika po zażądaniu poświadczeń użytkownika.

Type: String
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-Network Połączenie ivityDiagnosisTools

STRESZCZENIE

Funkcja main dla testów łączności sieciowej.

SKŁADNIA

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

OPIS

Uruchamia lokalne testy łączności sieciowej.

PRZYKŁADY

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PARAMETRY

-Lasu

Określa nazwę lasu do przetestowania.

Type: String
Parameter Sets: (All)
Aliases:

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

-Poświadczenia

Nazwa użytkownika i hasło użytkownika, który uruchamia test. Wymaga to tego samego poziomu uprawnień, które są wymagane do uruchomienia Kreatora Połączenie firmy Microsoft.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-LogFileLocation

Określa lokalizację pliku dziennika, który będzie zawierać dane wyjściowe tej funkcji.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Określ kontrolery domeny do przetestowania.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Flaga umożliwiająca wyświetlenie komunikatu o celu tej funkcji.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Zwraca wynik tej diagnozy w postaci obiektu PSObject. Nie trzeba określać podczas ręcznej interakcji z tym narzędziem.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Wskazuje, czy poświadczenia wpisane przez użytkownika są prawidłowe. Nie trzeba określać podczas ręcznej interakcji z tym narzędziem.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).