Condividi tramite


Microsoft Entra Connect: Informazioni di riferimento per PowerShell ADConnectivityTools

La documentazione seguente fornisce informazioni di riferimento per il ADConnectivityTools modulo PowerShell incluso in Microsoft Entra Connessione in C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-DnsConnectivity

RIEPILOGO

Rileva i problemi di DNS locali.

SYNTAX

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

DESCRIZIONE

Esegue test di connettività DNS locali. Per configurare il connettore Di Active Directory, il server Microsoft Entra Connessione deve avere entrambe la risoluzione dei nomi per la foresta a cui sta tentando di connettersi e ai controller di dominio associati a questa foresta.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

PARAMETERS

-Forest

Specifica il nome della foresta da testare.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Specifica i controller di dominio da testare.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Restituisce il risultato di questa diagnostica sotto forma di un oggetto PSObject. Non necessario durante l'interazione manuale con questo strumento.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

RIEPILOGO

Determina se la foresta specificata esiste.

SYNTAX

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

DESCRIZIONE

Esegue una query in un server DNS per gli indirizzi IP associati a una foresta.

ESEMPI

ESEMPIO 1

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

PARAMETERS

-Forest

Specifica il nome della foresta da testare.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

RIEPILOGO

Verifica il livello funzionale della foresta AD.

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIZIONE

Verifica che il livello funzionale della foresta AD sia uguale o superiore a un determinato valore MinAdForestVersion (WindowsServer2003). Potrebbero essere richiesti l'account (Dominio\Nome utente) e la password.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

ESEMPIO 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Foresta di destinazione. Il valore predefinito è la foresta dell'utente attualmente connesso.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Oggetto ForestFQDN di destinazione.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La funzione userà le credenziali dell'utente attualmente connesso nel computer, invece di richiedere credenziali personalizzate all'utente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-NetworkConnectivity

RIEPILOGO

Rileva i problemi di connettività di rete locale.

SYNTAX

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

DESCRIZIONE

Esegue test di connettività di rete locale.

Per i test di rete locali, Microsoft Entra Connessione deve essere in grado di comunicare con i controller di dominio denominati sulle porte 53 (DNS), 88 (Kerberos) e 389 (LDAP) La maggior parte delle organizzazioni esegue DNS nei controller di dominio, motivo per cui questo test è attualmente integrato. La porta 53 deve essere ignorata se è stato specificato un altro server DNS.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

PARAMETERS

-DCs

Specifica i controller di dominio da testare.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Se l'utente non usa i servizi DNS forniti dal controller di dominio active directory Site/Logon, potrebbe voler ignorare il controllo della porta 53. L'utente deve comunque essere in grado di risolvere _.ldap._tcp.<forestfqdn> affinché la configurazione del Connessione or di Active Directory abbia esito positivo.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Restituisce il risultato di questa diagnostica sotto forma di un oggetto PSObject. Non necessario durante l'interazione manuale con questo strumento.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

RIEPILOGO

Determina se una foresta specificata e i controller di dominio associati sono raggiungibili.

SYNTAX

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

DESCRIZIONE

Esegue test "ping" (se un computer può raggiungere un computer di destinazione attraverso la rete e/o Internet)

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

PARAMETERS

-Forest

Specifica il nome della foresta da testare.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Specifica i controller di dominio da testare.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

RIEPILOGO

Verifica che i domini nel nome di dominio completo della foresta ottenuto siano raggiungibili

SYNTAX

SamAccount

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

ForestFQDN

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

DESCRIZIONE

Verifica che tutti i domini nel nome di dominio completo della foresta ottenuto siano raggiungibili tentando di recuperare DomainGuid e DomainDN. Potrebbero essere richiesti l'account (Dominio\Nome utente) e la password.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

ESEMPIO 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Foresta di destinazione.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Oggetto ForestFQDN di destinazione.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La funzione userà le credenziali dell'utente attualmente connesso nel computer, invece di richiedere credenziali personalizzate all'utente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterpriseAdminCredentials

RIEPILOGO

Verifica se un utente ha le credenziali di amministratore aziendale.

SYNTAX

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

DESCRIZIONE

Esegue una ricerca per verificare se l'utente specificato ha le credenziali di amministratore aziendale. Potrebbero essere richiesti l'account (Dominio\Nome utente) e la password.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-RunWithCurrentlyLoggedInUserCredentials

La funzione userà le credenziali dell'utente attualmente connesso nel computer, invece di richiedere credenziali personalizzate all'utente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

RIEPILOGO

Recupera un DomainFQDN da una combinazione di account e password.

SYNTAX

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

DESCRIZIONE

Tenta di ottenere un oggetto domainFQDN dalle credenziali specificate. Se l'oggetto domainFQDN è valido, verrà restituito un DomainFQDNName o RootDomainName, a seconda della scelta dell'utente. Potrebbero essere richiesti l'account (Dominio\Nome utente) e la password.

ESEMPI

ESEMPIO 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

ESEMPIO 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-DomainFQDNDataType

Tipo di dati desiderato che verrà recuperato. Attualmente limitato a "DomainFQDNName" o "RootDomainName".

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La funzione userà le credenziali dell'utente attualmente connesso nel computer, invece di richiedere credenziali personalizzate all'utente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Parametro ausiliario usato dalla funzione Start-NetworkConnectivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

RIEPILOGO

Recupera un ForestFQDN da una combinazione di account e password.

SYNTAX

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

DESCRIZIONE

Tenta di ottenere un ForestFQDN dalle credenziali specificate. Potrebbero essere richiesti l'account (Dominio\Nome utente) e la password.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

PARAMETERS

-Forest

Foresta di destinazione. Il valore predefinito è il dominio dell'utente attualmente connesso.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La funzione userà le credenziali dell'utente attualmente connesso nel computer, invece di richiedere credenziali personalizzate all'utente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-ConnectivityValidation

RIEPILOGO

Funzione principale.

SYNTAX

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

DESCRIZIONE

Esegue tutti i meccanismi disponibili che verificano la validità delle credenziali di AD.

ESEMPI

ESEMPIO 1

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

PARAMETERS

-Forest

Foresta di destinazione.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreateConnectorAccount

Per installazioni personalizzate: contrassegno $True se l'utente ha scelto "Crea nuovo account AD" nella finestra Account foresta di Active Directory della procedura guidata di Microsoft Entra Connessione. $False se l'utente sceglie "Usare l'account AD esistente". Per installazioni rapide: il valore di questa variabile deve essere $True per le installazioni rapide.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserName

Parametro che precompila il campo del nome utente quando vengono richieste le credenziali dell'utente.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-NetworkConnectivityDiagnosisTools

RIEPILOGO

Funzione principale per i test di connettività di rete.

SYNTAX

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

DESCRIZIONE

Esegue test di connettività di rete locale.

ESEMPI

ESEMPIO 1

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

ESEMPIO 2

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

PARAMETERS

-Forest

Specifica il nome della foresta da testare.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

Nome utente e password dell'utente che esegue il test. Richiede lo stesso livello di autorizzazioni necessarie per eseguire la Procedura guidata di Connessione di Microsoft Entra.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-LogFileLocation

Specifica il percorso di un file di log che conterrà l'output di questa funzione.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Specifica i controller di dominio da testare.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Flag che consente di visualizzare un messaggio sullo scopo di questa funzione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Restituisce il risultato di questa diagnostica sotto forma di un oggetto PSObject. Non è necessario specificarlo durante l'interazione manuale con questo strumento.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Indica se le credenziali digitate dall'utente sono valide. Non è necessario specificarlo durante l'interazione manuale con questo strumento.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni seguenti: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).