Microsoft Entra Connect: ADConnectivityTools PowerShell – reference

Článek
11/06/2023

Následující dokumentace obsahuje referenční informace pro ADConnectivityTools modul PowerShellu, který je součástí microsoft Entra Připojení v C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-Dns Připojení ivity

SYNOPSE

Detekuje místní problémy s DNS.

SYNTAXE

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

POPIS

Spustí místní testy připojení DNS. Aby bylo možné nakonfigurovat konektor služby Active Directory, musí server Microsoft Entra Připojení mít pro doménovou strukturu, ke které se pokouší připojit, i k řadičům domény přidruženým k této doménové struktuře.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PARAMETRY

-Doménové struktury

Určuje název doménové struktury, na které se má testovat.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Zadejte řadiče domény, které se mají testovat.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Vrátí výsledek této diagnostiky ve formě objektu PSObject. Při ruční interakci s tímto nástrojem není nutné.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

SYNOPSE

Určuje, jestli zadaná doménová struktura existuje.

SYNTAXE

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

POPIS

Dotazuje server DNS na IP adresy přidružené k doménové struktuře.

PŘÍKLADY

PŘÍKLAD 1

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

PARAMETRY

-Doménové struktury

Určuje název doménové struktury, na které se má testovat.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-FunctionalLevel

SYNOPSE

Ověřuje funkční úroveň doménové struktury AD.

SYNTAXE

SamAccount

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

Doménová struktura

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

POPIS

Ověřuje, že úroveň funkčnosti doménové struktury AD je rovna nebo více než daná hodnota MinAdForestVersion (WindowsServer2003). Je možné požádat o účet (doména\uživatelské jméno) a heslo.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PŘÍKLAD 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-Doménové struktury

Cílová doménová struktura Výchozí hodnota je doménová struktura aktuálně přihlášeného uživatele.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Cílový objekt ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkce použije přihlašovací údaje uživatele, který je aktuálně přihlášený v počítači, místo vyžádání vlastních přihlašovacích údajů od uživatele.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-Network Připojení ivity

SYNOPSE

Detekuje problémy s připojením k místní síti.

SYNTAXE

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

POPIS

Spustí testy připojení k místní síti.

V případě místních síťových testů musí být Microsoft Entra Připojení schopný komunikovat s pojmenovanými řadiči domény na portech 53 (DNS), 88 (Kerberos) a 389 (LDAP) Většina organizací spouští DNS na svých řadičích domény, což je důvod, proč je tento test aktuálně integrovaný. Port 53 by se měl přeskočit, pokud byl zadán jiný server DNS.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PARAMETRY

-Dcs

Zadejte řadiče domény, které se mají testovat.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Pokud uživatel nepoužívá služby DNS poskytované řadičem domény ad site/logon, může chtít přeskočit kontrolu portu 53. Uživatel musí být stále schopen vyřešit _.ldap._tcp.<doménovýfqdn>, aby konfigurace služby Active Directory Připojení or byla úspěšná.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Vrátí výsledek této diagnostiky ve formě objektu PSObject. Při ruční interakci s tímto nástrojem není nutné.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-TargetsAreReachable

SYNOPSE

Určuje, jestli je dostupná zadaná doménová struktura a její přidružené řadiče domény.

SYNTAXE

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

POPIS

Spustí testy ping (jestli se počítač může spojit s cílovým počítačem přes síť nebo internet).

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PARAMETRY

-Doménové struktury

Určuje název doménové struktury, na které se má testovat.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Zadejte řadiče domény, které se mají testovat.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidDomains

SYNOPSE

Ověřte, že domény v získaném plně kvalifikovaném názvu domény doménové struktury jsou dostupné.

SYNTAXE

SamAccount

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

Doménová struktura

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

POPIS

Ověřte, že všechny domény v získaném plně kvalifikovaném názvu domény doménové struktury jsou dostupné pokusem o načtení DomainGuid a DomainDN. Je možné požádat o účet (doména\uživatelské jméno) a heslo.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PŘÍKLAD 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-Doménové struktury

Cílová doménová struktura

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Cílový objekt ForestFQDN.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkce použije přihlašovací údaje uživatele, který je aktuálně přihlášený v počítači, místo vyžádání vlastních přihlašovacích údajů od uživatele.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidEnterprise Správa Credentials

SYNOPSE

Ověří, jestli má uživatel přihlašovací údaje enterprise Správa.

SYNTAXE

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

POPIS

Vyhledá, pokud má zadaný uživatel přihlašovací údaje enterprise Správa. Je možné požádat o účet (doména\uživatelské jméno) a heslo.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETRY

-RunWithCurrentlyLoggedInUserCredentials

Funkce použije přihlašovací údaje uživatele, který je aktuálně přihlášený v počítači, místo vyžádání vlastních přihlašovacích údajů od uživatele.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Get-DomainFQDNData

SYNOPSE

Načte doménaFQDN z kombinace účtu a hesla.

SYNTAXE

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

POPIS

Pokusí se získat objekt domainFQDN z poskytnutých přihlašovacích údajů. Pokud je doménaFQDN platná, v závislosti na volbě uživatele se vrátí název DomainFQDNName nebo RootDomainName. Je možné požádat o účet (doména\uživatelské jméno) a heslo.

PŘÍKLADY

PŘÍKLAD 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

PŘÍKLAD 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETRY

-DomainFQDNDataType

Požadovaný druh dat, která se načtou. V současné době je omezeno na DomainFQDNName nebo RootDomainName.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkce použije přihlašovací údaje uživatele, který je aktuálně přihlášený v počítači, místo vyžádání vlastních přihlašovacích údajů od uživatele.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Pomocný parametr používaný funkcí Start-Network Připojení ivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Get-ForestFQDN

SYNOPSE

Načte doménový název domény z kombinace účtu a hesla.

SYNTAXE

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

POPIS

Pokusí se z zadaných přihlašovacích údajů získat plně kvalifikovaný název domény doménové struktury. Je možné požádat o účet (doména\uživatelské jméno) a heslo.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PARAMETRY

-Doménové struktury

Cílová doménová struktura Výchozí hodnota je Doména aktuálně přihlášeného uživatele.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

Funkce použije přihlašovací údaje uživatele, který je aktuálně přihlášený v počítači, místo vyžádání vlastních přihlašovacích údajů od uživatele.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-Připojení ivityValidation

SYNOPSE

Hlavní funkce.

SYNTAXE

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

POPIS

Spustí všechny dostupné mechanismy, které ověřují platnost přihlašovacích údajů AD.

PŘÍKLADY

PŘÍKLAD 1

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

PARAMETRY

-Doménové struktury

Cílová doménová struktura

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreate Připojení orAccount

U vlastních instalací: Označte příznakem, který je $True, pokud uživatel v okně Účet doménové struktury SLUŽBY AD v průvodci Microsoft Entra Připojení zvolil možnost Vytvořit nový účet AD. $False, pokud uživatel zvolil možnost Použít existující účet AD. Pro expresní instalace: Hodnota této proměnné musí být $True pro instalace Express.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Username

Parametr, který předplní pole Uživatelské jméno při vyžádání přihlašovacích údajů uživatele.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-Network Připojení ivityDiagnosisTools

SYNOPSE

Hlavní funkce pro testy síťového připojení

SYNTAXE

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

POPIS

Spustí testy připojení k místní síti.

PŘÍKLADY

PŘÍKLAD 1

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

PŘÍKLAD 2

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

PARAMETRY

-Doménové struktury

Určuje název doménové struktury, který se má testovat.

Type: String
Parameter Sets: (All)
Aliases:

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

-Pověření

Uživatelské jméno a heslo uživatele, který test spouští. Vyžaduje stejnou úroveň oprávnění, která je nutná ke spuštění průvodce Microsoft Entra Připojení.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-LogFileLocation

Určuje umístění souboru protokolu, který bude obsahovat výstup této funkce.

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

Zadejte řadiče domény, které se mají testovat.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Příznak, který umožňuje zobrazit zprávu o účelu této funkce.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Vrátí výsledek této diagnostiky ve formě objektu PSObject. Při ruční interakci s tímto nástrojem není nutné zadávat.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Určuje, jestli jsou přihlašovací údaje zadané uživatelem platné. Při ruční interakci s tímto nástrojem není nutné zadávat.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Sdílet prostřednictvím

Microsoft Entra Connect: ADConnectivityTools PowerShell – reference

Confirm-Dns Připojení ivity

SYNOPSE

SYNTAXE

POPIS

PŘÍKLADY

PŘÍKLAD 1

PŘÍKLAD 2

PARAMETRY

-Doménové struktury

-Dcs

-ReturnResultAsPSObject

CommonParameters

Confirm-ForestExists

SYNOPSE

SYNTAXE

POPIS

PŘÍKLADY

PŘÍKLAD 1

PARAMETRY

-Doménové struktury

CommonParameters

Confirm-FunctionalLevel

SYNOPSE

SYNTAXE

SamAccount

Doménová struktura

POPIS

PŘÍKLADY

PŘÍKLAD 1

PŘÍKLAD 2

PŘÍKLAD 3

PARAMETRY

-Doménové struktury

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-Network Připojení ivity

SYNOPSE

SYNTAXE

POPIS

PŘÍKLADY

PŘÍKLAD 1

PŘÍKLAD 2

PARAMETRY

-Dcs

-SkipDnsPort

-ReturnResultAsPSObject

CommonParameters

Confirm-TargetsAreReachable

SYNOPSE

SYNTAXE

POPIS

PŘÍKLADY

PŘÍKLAD 1

PŘÍKLAD 2

PARAMETRY

-Doménové struktury

-Dcs

CommonParameters

Confirm-ValidDomains

SYNOPSE

SYNTAXE

SamAccount

Doménová struktura

POPIS

PŘÍKLADY

PŘÍKLAD 1

PŘÍKLAD 2

PŘÍKLAD 3

PARAMETRY

-Doménové struktury

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-ValidEnterprise Správa Credentials

SYNOPSE

SYNTAXE

POPIS