Microsoft Entra Connect: ADConnectivityTools PowerShell 참조

아티클
11/06/2023

다음 설명서는 C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1의 Microsoft Entra Connect에 포함된 ADConnectivityTools PowerShell 모듈에 대한 참조 정보를 제공합니다.

Confirm-DnsConnectivity

개요

로컬 DNS 문제를 검색합니다.

SYNTAX

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

설명

로컬 DNS 연결 테스트를 실행합니다. Active Directory Connector를 구성하려면 Microsoft Entra Connect 서버에 연결을 시도하는 포리스트와 이 포리스트에 연결된 도메인 컨트롤러에 대한 이름 확인이 모두 있어야 합니다.

예제

예제 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

테스트할 DC를 지정합니다.

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

이 cmdlet 일반 매개 변수를 지원합니다. -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction 및 -WarningVariable. 자세한 내용은 about_CommonParameters(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

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

Confirm-NetworkConnectivity

개요

로컬 네트워크 연결 문제를 검색합니다.

SYNTAX

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

설명

로컬 네트워크 연결 테스트를 실행합니다.

로컬 네트워킹 테스트의 경우 Microsoft Entra Connect는 53(DNS), 88(Kerberos) 및 389(LDAP) 포트에서 명명된 도메인 컨트롤러와 통신할 수 있어야 합니다. 대부분의 조직에서는 자체의 DC에서 DNS를 실행하므로 이 테스트가 현재 통합되어 있습니다. 다른 DNS 서버가 지정되면 53 포트를 건너뛰어야 합니다.

예제

예제 1

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

예제 2

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

PARAMETERS

-DCs

테스트할 DC를 지정합니다.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

사용자가 AD 사이트/로그온 DC에서 제공하는 DNS 서비스를 사용하지 않는 경우 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

Confirm-TargetsAreReachable

개요

지정된 포리스트 및 해당 연결된 도메인 컨트롤러에 연결할 수 있는지 확인합니다.

SYNTAX

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"

PARAMETERS

-Forest

테스트할 포리스트의 이름을 지정합니다.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

테스트할 DC를 지정합니다.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidDomains

개요

가져온 포리스트 FQDN의 도메인에 연결할 수 있는지 확인합니다.

SYNTAX

SamAccount

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

ForestFQDN

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

설명

DomainGuid 및 DomainDN을 검색하려고 시도하여 가져온 포리스트 FQDN의 모든 도메인에 연결할 수 있는지 확인합니다. 계정(도메인\사용자 이름) 및 암호를 요청할 수 있습니다.

예제

예제 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

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

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

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

Start-ConnectivityValidation

개요

Main 함수입니다.

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

사용자 지정 설치의 경우 사용자가 Microsoft Entra Connect 마법사의 AD 포리스트 계정 창에서 "새 AD 계정 만들기"를 선택한 경우 플래그는 $True입니다. 사용자가 "기존 AD 계정 사용"을 선택한 경우 $False입니다. 기본 설치의 경우 기본 설치에 대한 이 변수의 값은 $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

Start-NetworkConnectivityDiagnosisTools

개요

네트워크 연결 테스트를 위한 Main 함수입니다.

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 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

테스트할 DC를 지정합니다.

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

다음을 통해 공유

Microsoft Entra Connect: ADConnectivityTools PowerShell 참조

Confirm-DnsConnectivity

개요

SYNTAX

설명

예제

예제 1

예제 2

PARAMETERS

-Forest

-DCs

-ReturnResultAsPSObject

CommonParameters

Confirm-ForestExists

개요

SYNTAX

설명

예제

예제 1

PARAMETERS

-Forest

CommonParameters

Confirm-FunctionalLevel

개요

SYNTAX

SamAccount

ForestFQDN

설명

예제

예제 1

예제 2

예제 3

PARAMETERS

-Forest

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-NetworkConnectivity

개요

SYNTAX

설명

예제

예제 1

예제 2

PARAMETERS

-DCs

-SkipDnsPort

-ReturnResultAsPSObject

CommonParameters

Confirm-TargetsAreReachable

개요

SYNTAX

설명

예제

예제 1

예제 2

PARAMETERS

-Forest

-DCs

CommonParameters

Confirm-ValidDomains

개요

SYNTAX

SamAccount

ForestFQDN

설명

예제

예제 1

예제 2

예제 3

PARAMETERS

-Forest

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-ValidEnterpriseAdminCredentials

개요

SYNTAX

설명