Teilen über

Microsoft Entra Connect: PowerShell-Referenz zu ADConnectivityTools

  • Artikel

Die folgende Dokumentation enthält Referenzinformationen für das PowerShell-Modul „ADConnectivityTools“, das in C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1 in Microsoft Entra Connect enthalten ist.

Confirm-DnsConnectivity

ZUSAMMENFASSUNG

Erkennt lokale DNS-Probleme.

SYNTAX

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

DESCRIPTION

Führt lokale DNS-Konnektivitätstests aus. Um den Active Directory-Connector zu konfigurieren, muss der Microsoft Entra Connect-Server über Namensauflösung verfügen, sowohl für die Gesamtstruktur, mit der eine Verbindung hergestellt werden soll, als auch in den Domänencontrollern, die dieser Gesamtstruktur zugeordnet sind.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

PARAMETERS

-Forest

Gibt den Namen der zu testenden Gesamtstruktur an.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Zu testende DCs eingeben.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Gibt das Ergebnis dieser Diagnose in Form eines „PSObject“ zurück. Während manueller Interaktion mit diesem Tool nicht erforderlich.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

ZUSAMMENFASSUNG

Bestimmt, ob eine angegebene Gesamtstruktur vorhanden ist.

SYNTAX

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

DESCRIPTION

Fragt bei einem DNS-Server die IP-Adressen ab, die einer Gesamtstruktur zugeordnet sind.

BEISPIELE

BEISPIEL 1

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

PARAMETERS

-Forest

Gibt den Namen der zu testenden Gesamtstruktur an.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

ZUSAMMENFASSUNG

Überprüft die Funktionsebene der Active Directory-Gesamtstruktur.

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIPTION

Überprüft, ob die Funktionsebene der AD-Gesamtstruktur gleich oder höher als eine angegebene „MinAdForestVersion“ (WindowsServer2003) ist. Konto (Domäne\Benutzername) und Kennwort werden möglicherweise angefordert.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

BEISPIEL 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Zielgesamtstruktur. Standardwert ist die Gesamtstruktur des aktuell angemeldeten Benutzers.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

ForestFQDN-Zielobjekt.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Die Funktion verwendet die Anmeldeinformationen des Benutzers, der derzeit bei dem Computer angemeldet ist statt benutzerdefinierte Anmeldeinformationen vom Benutzer anzufordern.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-NetworkConnectivity

ZUSAMMENFASSUNG

Erkennt lokale Netzwerkkonnektivitätsprobleme.

SYNTAX

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

DESCRIPTION

Führt lokale Netzwerkkonnektivitätstests aus.

Für die lokalen Netzwerktests muss Microsoft Entra Connect in der Lage sein, mit den benannten Domänencontrollern an den Ports 53 (DNS), 88 (Kerberos) und 389 (LDAP) zu kommunizieren. Die meisten Organisationen führen DNS auf ihren DCs aus, weshalb dieser Test derzeit integriert ist. Port 53 sollte übersprungen werden, wenn ein anderer DNS-Server angegeben wurde.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

PARAMETERS

-DCs

Zu testende DCs eingeben.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Wenn der Benutzer keine vom AD-Standort/Anmelde-DC bereitgestellten DNS-Dienste verwendet, sollte er eventuell die Überprüfung von Port 53 überspringen. Der Benutzer muss weiterhin in der Lage sein, „_.ldap._tcp.<forestfqdn>“ aufzulösen, damit die Active Directory Connector-Konfiguration erfolgreich erfolgen kann.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Gibt das Ergebnis dieser Diagnose in Form eines „PSObject“ zurück. Während manueller Interaktion mit diesem Tool nicht erforderlich.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

ZUSAMMENFASSUNG

Bestimmt, ob eine angegebene Gesamtstruktur und ihre zugeordneten Domänencontroller erreichbar sind.

SYNTAX

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

DESCRIPTION

Führt Pingtests aus (ob ein Computer einen Zielcomputer über das Netzwerk und/oder das Internet erreichen kann).

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

PARAMETERS

-Forest

Gibt den Namen der zu testenden Gesamtstruktur an.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Zu testende DCs eingeben.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

ZUSAMMENFASSUNG

Überprüfen Sie, ob die Domänen im abgerufenen Gesamtstruktur-FQDN erreichbar sind.

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIPTION

Überprüfen Sie, ob alle Domänen im abgerufenen Gesamtstruktur-FQDN erreichbar sind, indem Sie versuchen, „DomainGuid“ und „DomainDN“ abzurufen. Konto (Domäne\Benutzername) und Kennwort werden möglicherweise angefordert.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

BEISPIEL 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Zielgesamtstruktur.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

ForestFQDN-Zielobjekt.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Die Funktion verwendet die Anmeldeinformationen des Benutzers, der derzeit bei dem Computer angemeldet ist statt benutzerdefinierte Anmeldeinformationen vom Benutzer anzufordern.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterpriseAdminCredentials

ZUSAMMENFASSUNG

Überprüft, ob ein Benutzer Unternehmensadministrator-Anmeldeinformationen besitzt.

SYNTAX

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

DESCRIPTION

Sucht, ob der angegebene Benutzer Unternehmensadministrator-Anmeldeinformationen besitzt. Konto (Domäne\Benutzername) und Kennwort werden möglicherweise angefordert.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-RunWithCurrentlyLoggedInUserCredentials

Die Funktion verwendet die Anmeldeinformationen des Benutzers, der derzeit bei dem Computer angemeldet ist statt benutzerdefinierte Anmeldeinformationen vom Benutzer anzufordern.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

ZUSAMMENFASSUNG

Ruft einen DomainFQDN aus einer Konto- und Kennwort-Kombination ab.

SYNTAX

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

DESCRIPTION

Versucht, ein domainFQDN-Objekt aus angegebenen Anmeldeinformationen abzurufen. Wenn der DomainFQDN gültig ist, wird ein DomainFQDNName oder RootDomainName zurückgegeben, je nach Auswahl des Benutzers. Konto (Domäne\Benutzername) und Kennwort werden möglicherweise angefordert.

BEISPIELE

BEISPIEL 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

BEISPIEL 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-DomainFQDNDataType

Die gewünschte Art von Daten, die abgerufen werden. Aktuell beschränkt auf „DomainFQDNName“ oder „RootDomainName“.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Die Funktion verwendet die Anmeldeinformationen des Benutzers, der derzeit bei dem Computer angemeldet ist statt benutzerdefinierte Anmeldeinformationen vom Benutzer anzufordern.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Zusätzlicher Parameter, der von der Funktion „Start-NetworkConnectivityDiagnosisTools“ verwendet wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

ZUSAMMENFASSUNG

Ruft einen ForestFQDN aus einer Konto- und Kennwort-Kombination ab.

SYNTAX

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

DESCRIPTION

Versucht, einen ForestFQDN aus angegebenen Anmeldeinformationen abzurufen. Konto (Domäne\Benutzername) und Kennwort werden möglicherweise angefordert.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

PARAMETERS

-Forest

Standardgesamtstruktur. Standardwert ist die Domäne des aktuell angemeldeten Benutzers.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Die Funktion verwendet die Anmeldeinformationen des Benutzers, der derzeit bei dem Computer angemeldet ist statt benutzerdefinierte Anmeldeinformationen vom Benutzer anzufordern.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-ConnectivityValidation

ZUSAMMENFASSUNG

Hauptfunktion.

SYNTAX

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

DESCRIPTION

Führt alle verfügbaren Mechanismen aus, die überprüfen, ob AD-Anmeldeinformationen gültig sind.

BEISPIELE

BEISPIEL 1

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

PARAMETERS

-Forest

Zielgesamtstruktur.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreateConnectorAccount

Für benutzerdefinierte Installationen: Das Flag, das „$True“ ist, wenn der Benutzer „Neues AD-Konto erstellen“ im Fenster „AD-Gesamtstrukturkonto“ des Microsoft Entra Connect-Assistenten ausgewählt hat. „$False“, wenn der Benutzer „Vorhandenes AD-Konto verwenden“ ausgewählt hat. Für Expressinstallationen: Der Wert dieser Variablen muss für Expressinstallationen „$True“ lauten.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserName

Der Parameter, der das Feld „Username“ im Voraus auffüllt, wenn die Anmeldeinformationen des Benutzers angefordert werden.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-NetworkConnectivityDiagnosisTools

ZUSAMMENFASSUNG

Hauptfunktion für Netzwerkkonnektivitätstests.

SYNTAX

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

DESCRIPTION

Führt lokale Netzwerkkonnektivitätstests aus.

BEISPIELE

BEISPIEL 1

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

BEISPIEL 2

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

PARAMETERS

-Forest

Gibt den Namen der zu testenden Gesamtstruktur an.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

Der Benutzernamen und das Kennwort des Benutzers, der den Test ausführt. Erfordert dieselbe Berechtigungsstufe, die zur Ausführung des Microsoft Entra Connect-Assistenten erforderlich ist.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-LogFileLocation

Gibt den Speicherort einer Protokolldatei an, welche die Ausgabe dieser Funktion enthält.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Zu testende DCs eingeben.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Flag, das die Anzeige einer Meldung zum Zweck dieser Funktion ermöglicht.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Gibt das Ergebnis dieser Diagnose in Form eines „PSObject“ zurück. Muss während der manuellen Interaktion mit diesem Tool nicht angegeben werden.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Zeigt an, ob die vom Benutzer eingegebenen Anmeldeinformationen gültig sind. Muss während der manuellen Interaktion mit diesem Tool nicht angegeben werden.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt diese gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter „about_CommonParameters“ (https://go.microsoft.com/fwlink/?LinkID=113216).