Microsoft Entra Connect: Referência do PowerShell ADConnectivityTools

Artigo
11/06/2023

A documentação a seguir fornece informações de referência sobre o módulo ADConnectivityTools do PowerShell que está incluído no Microsoft Entra Connect no C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-DnsConnectivity

SINOPSE

Detecta problemas de DNS local.

SYNTAX

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

DESCRIPTION

Executa testes de conectividade de DNS local. Para configurar o conector do Active Directory, o servidor Microsoft Entra Connect deverá ter resolução de nome para a floresta à qual está tentando conectar, bem como para os controladores de domínio associados a essa floresta.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARAMETERS

-Forest

Especifica o nome da floresta para o teste.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica os DCs para o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retorna o resultado deste diagnóstico na forma de um PSObject. Não é necessário durante a interação manual com essa ferramenta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet oferece suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para saber mais, confira sobre_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

SINOPSE

Determina se uma floresta especificada existe.

SYNTAX

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

DESCRIPTION

Consulta os endereços IP associados a uma floresta em um servidor DNS.

EXEMPLOS

EXEMPLO 1

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

PARAMETERS

-Forest

Especifica o nome da floresta para o teste.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-FunctionalLevel

SINOPSE

Verifica o nível funcional de floresta do AD.

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIPTION

Verifica se o nível funcional de floresta do AD é igual ou maior que um determinado MinAdForestVersion (WindowsServer2003). A conta (Domínio\Nome de usuário) e a senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

EXEMPLO 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Floresta de destino. O valor padrão é a floresta do usuário atualmente conectado.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Objeto ForestFQDN de destino.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que fez logon no computador em vez de solicitar credenciais personalizadas do usuário.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-NetworkConnectivity

SINOPSE

Detecta problemas de conectividade de rede local.

SYNTAX

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

DESCRIPTION

Executa testes de conectividade de rede local.

Para os testes de rede local, o Microsoft Entra Connect deve ser capaz de se comunicar com os controladores de domínio nomeados nas portas 53 (DNS), 88 (Kerberos) e 389 (LDAP); a maioria das organizações executam DNS em seus controladores de domínio, por isso esse teste é atualmente integrado. A porta 53 deverá ser ignorada se outro servidor DNS tiver sido especificado.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARAMETERS

-DCs

Especifica os DCs para o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Se o usuário não está usando os serviços DNS fornecidos pelo Site do AD/DC de Logon, talvez queira ignorar a verificação da porta 53. O usuário ainda deverá ser capaz de resolver _.ldap._tcp.<forestfqdn> para que a configuração Conector do Active Directory seja bem-sucedida.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retorna o resultado deste diagnóstico na forma de um PSObject. Não é necessário durante a interação manual com essa ferramenta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-TargetsAreReachable

SINOPSE

Determina se uma floresta especificada e seus Controladores de Domínio associados estão acessíveis.

SYNTAX

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

DESCRIPTION

Executa testes de "ping" (se o computador pode acessar um computador de destino por meio da rede e/ou da Internet)

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARAMETERS

-Forest

Especifica o nome da floresta para o teste.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica os DCs para o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidDomains

SINOPSE

Validar se os domínios no FQDN da floresta obtido estão acessíveis

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIPTION

Valida se todos os domínios no FQDN de floresta obtido estão acessíveis por meio da tentativa de recuperar DomainGuid e DomainDN. A conta (Domínio\Nome de usuário) e a senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

EXEMPLO 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Floresta de destino.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Objeto ForestFQDN de destino.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que fez logon no computador em vez de solicitar credenciais personalizadas do usuário.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidEnterpriseAdminCredentials

SINOPSE

Verifica se um usuário tem credenciais de Admin Corporativo.

SYNTAX

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

DESCRIPTION

Pesquisa se o usuário fornecido tem credenciais de Admin Corporativo. A conta (Domínio\Nome de usuário) e a senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que fez logon no computador em vez de solicitar credenciais personalizadas do usuário.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Get-DomainFQDNData

SINOPSE

Recupera um DomainFQDN de uma combinação de conta e senha.

SYNTAX

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

DESCRIPTION

Tenta obter um objeto domainFQDN de credenciais fornecidas. Se o domainFQDN for válido, um DomainFQDNName ou RootDomainName será retornado, dependendo da escolha do usuário. A conta (Domínio\Nome de usuário) e a senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

EXEMPLO 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-DomainFQDNDataType

Tipo de dados desejado que será recuperado. No momento, limitado a "DomainFQDNName" ou "RootDomainName".

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que fez logon no computador em vez de solicitar credenciais personalizadas do usuário.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Parâmetro auxiliar usado pela função 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

SINOPSE

Recupera um ForestFQDN de uma combinação de conta e senha.

SYNTAX

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

DESCRIPTION

Tenta obter um ForestFQDN das credenciais fornecidas. A conta (Domínio\Nome de usuário) e a senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARAMETERS

-Forest

O valor forest.Default de destino é o Domínio do usuário atualmente conectado.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que fez logon no computador em vez de solicitar credenciais personalizadas do usuário.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-ConnectivityValidation

SINOPSE

Função principal.

SYNTAX

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

DESCRIPTION

Executa todos os mecanismos disponíveis que verificam se as credenciais do AD são válidas.

EXEMPLOS

EXEMPLO 1

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

PARAMETERS

-Forest

Floresta de destino.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreateConnectorAccount

Para Custom-installations: sinaliza que será $True se o usuário escolher "Criar nova conta do AD" na janela de Conta da Floresta do AD do Assistente do Microsoft Entra Connect. $False se o usuário escolher "Usar conta existente do AD". Para Express-installations: o valor dessa variável deve ser $True para Express-installations.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserName

Parâmetro que pré-preenche o campo de Nome de usuário quando as credenciais do usuário são solicitadas.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-NetworkConnectivityDiagnosisTools

SINOPSE

Função principal para testes de conectividade de rede.

SYNTAX

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

DESCRIPTION

Executa testes de conectividade de rede local.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARAMETERS

-Forest

Especifica o nome da floresta para o teste.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

O nome de usuário e senha do usuário que está executando o teste. Exige o mesmo nível de permissões que é necessário para executar o Assistente do 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

Especifica a localização de um arquivo de log que conterá a saída dessa função.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica os DCs para o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Sinalizador que permite exibir uma mensagem sobre a finalidade dessa função.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retorna o resultado deste diagnóstico na forma de um PSObject. Não é necessário especificar durante a interação manual com essa ferramenta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Indica se as credenciais que o usuário digitou são válidas. Não é necessário especificar durante a interação manual com essa ferramenta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet oferece suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para saber mais, confira about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Compartilhar via

Microsoft Entra Connect: Referência do PowerShell ADConnectivityTools

Confirm-DnsConnectivity

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Forest

-DCs

-ReturnResultAsPSObject

CommonParameters

Confirm-ForestExists

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

PARAMETERS

-Forest

CommonParameters

Confirm-FunctionalLevel

SINOPSE

SYNTAX

SamAccount

ForestFQDN

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARAMETERS

-Forest

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-NetworkConnectivity

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-DCs

-SkipDnsPort

-ReturnResultAsPSObject

CommonParameters

Confirm-TargetsAreReachable

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Forest

-DCs

CommonParameters

Confirm-ValidDomains

SINOPSE

SYNTAX

SamAccount

ForestFQDN

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARAMETERS

-Forest

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-ValidEnterpriseAdminCredentials

SINOPSE

SYNTAX

DESCRIPTION