Microsoft Entra Connect: Referência do PowerShell ADConnectivityTools

Artigo
11/06/2023

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

Confirmar-DnsConnectivity

SINOPSE

Deteta problemas de Dns locais.

SINTAXE

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

DESCRIÇÃO

Executa testes de conectividade Dns locais. Para configurar o conector do Ative Directory, o servidor Microsoft Entra Connect deve ter resolução de nomes para a floresta à qual está tentando se 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"

PARÂMETROS

-Floresta

Especifica o nome da floresta a ser testada.

Type: String
Parameter Sets: (All)
Aliases:

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

-CDs

Especifique os DCs contra os quais testar o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Devolve o resultado deste diagnóstico sob a forma de um PSObject. Não é necessário durante a interação manual com esta 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirmar-ForestExists

SINOPSE

Determina se existe uma floresta especificada.

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

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

PARÂMETROS

-Floresta

Especifica o nome da floresta a ser testada.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirmar-FuncionalNível

SINOPSE

Verifica o nível funcional da floresta do AD.

SINTAXE

SamAccount

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

ForestFQDN

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

DESCRIÇÃO

Verifica se o nível funcional da floresta do AD é igual ou superior a um determinado MinAdForestVersion (WindowsServer2003). Conta (Domínio\Nome de Usuário) e 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

PARÂMETROS

-Floresta

Floresta alvo. O valor padrão é a Floresta do usuário conectado no momento.

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 está atualmente conectado 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

Confirmar-NetworkConnectivity

SINOPSE

Deteta problemas de conectividade de rede local.

SINTAXE

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

DESCRIÇÃO

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 executa DNS em seus DCs, e é por isso que esse teste está atualmente integrado. A porta 53 deve 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

PARÂMETROS

-CDs

Especifique os DCs contra os quais testar 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 estiver 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 deve ser capaz de resolver _.ldap._tcp.<forestfqdn> para que a configuração do Ative Directory Connector 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

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirmar-AlvosSãoAlcançáveis

SINOPSE

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

SINTAXE

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

DESCRIÇÃO

Executa testes de "ping" (se um computador pode chegar a um computador de destino através 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"

PARÂMETROS

-Floresta

Especifica o nome da floresta a ser testada.

Type: String
Parameter Sets: (All)
Aliases:

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

-CDs

Especifique os DCs contra os quais testar o teste.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirmar-ValidDomains

SINOPSE

Valide se os domínios no FQDN de floresta obtido estão acessíveis

SINTAXE

SamAccount

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

ForestFQDN

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

DESCRIÇÃO

Valide se todos os domínios no FQDN de floresta obtido estão acessíveis tentando recuperar DomainGuid e DomainDN. Conta (Domínio\Nome de Usuário) e 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

PARÂMETROS

-Floresta

Floresta alvo.

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 está atualmente conectado 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 administrador corporativo.

SINTAXE

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

DESCRIÇÃO

Pesquisas se o usuário fornecido tiver credenciais de administrador corporativo. Conta (Domínio\Nome de Usuário) e Senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARÂMETROS

-RunWithCurrentlyLoggedInUserCredentials

A função usará as credenciais do usuário que está atualmente conectado 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.

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

EXEMPLO 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARÂMETROS

-DomainFQDNDataType

Tipo desejado de dados que serão recuperados. Atualmente 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 está atualmente conectado 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.

SINTAXE

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

DESCRIÇÃO

Tenta obter um ForestFQDN das credenciais fornecidas. Conta (Domínio\Nome de Usuário) e Senha podem ser solicitadas.

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARÂMETROS

-Floresta

Floresta alvo. O valor padrão é o Domínio do usuário conectado no momento.

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 está atualmente conectado 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.

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Floresta

Floresta alvo.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreateConnectorAccount

Para instalações personalizadas: sinalizador que é $True se o usuário escolher "Criar nova conta do AD" na janela Conta da Floresta do AD do assistente do Microsoft Entra Connect. $False se o usuário escolher "Usar conta do AD existente". Para instalações expressas: O valor dessa variável deve ser $True para instalações expressas.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Nome de Utilizador

Parâmetro que preenche previamente o campo 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.

SINTAXE

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

DESCRIÇÃO

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"

PARÂMETROS

-Floresta

Especifica o nome da floresta para teste.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credenciais

O nome de usuário e senha do usuário que está executando o teste. Requer o mesmo nível de permissões 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 o local 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

-CDs

Especifique os DCs contra os quais testar 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 desta função.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Devolve o resultado deste diagnóstico sob a forma de um PSObject. Não é necessário especificar durante a interação manual com esta 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 digitadas pelo usuário são válidas. Não é necessário especificar durante a interação manual com esta ferramenta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Partilhar via

Microsoft Entra Connect: Referência do PowerShell ADConnectivityTools

Confirmar-DnsConnectivity

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Floresta

-CDs

-ReturnResultAsPSObject

CommonParameters

Confirmar-ForestExists

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

PARÂMETROS

-Floresta

CommonParameters

Confirmar-FuncionalNível

SINOPSE

SINTAXE

SamAccount

ForestFQDN

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARÂMETROS

-Floresta

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirmar-NetworkConnectivity

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-CDs

-SkipDnsPort

-ReturnResultAsPSObject

CommonParameters

Confirmar-AlvosSãoAlcançáveis

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Floresta

-CDs

CommonParameters

Confirmar-ValidDomains

SINOPSE

SINTAXE

SamAccount

ForestFQDN

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARÂMETROS

-Floresta

-ForestFQDN

-RunWithCurrentlyLoggedInUserCredentials

CommonParameters

Confirm-ValidEnterpriseAdminCredentials

SINOPSE

SINTAXE

DESCRIÇÃO