Compartir vía

Microsoft Entra Connect: Referencia de PowerShell ADConnectivityTools

  • Artículo

La siguiente documentación proporciona información de referencia para el ADConnectivityToolsmódulo PowerShell incluido con Microsoft Entra Connect en C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-DnsConnectivity

SINOPSIS

Detecta problemas de DNS locales.

SINTAXIS

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

DESCRIPTION

Ejecuta pruebas de conectividad de DNS locales. Para configurar el conector de Active Directory, el servidor de Microsoft Entra Connect debe tener tanto la resolución de nombres del bosque al que intenta conectarse, así como en los controladores de dominio asociados a este bosque.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

PARAMETERS

-Forest

Especifica el nombre del bosque en el que se realizará la prueba.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica los controladores de dominio en los que se realizará la prueba.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Devuelve el resultado de este diagnóstico en forma de objeto PSObject. No es necesario durante la interacción manual con esta herramienta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

SINOPSIS

Determina si existe un bosque especificado.

SINTAXIS

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

DESCRIPTION

Consulta un servidor DNS para obtener las direcciones IP asociadas con un bosque.

EJEMPLOS

EJEMPLO 1

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

PARAMETERS

-Forest

Especifica el nombre del bosque en el que se realizará la prueba.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-FunctionalLevel

SINOPSIS

Comprueba el nivel funcional del bosque de AD.

SINTAXIS

SamAccount

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

ForestFQDN

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

DESCRIPTION

Comprueba que el nivel funcional del bosque de AD es igual o mayor que una versión MinAdForestVersion determinada (WindowsServer2003). Se pueden solicitar la cuenta (dominio\nombre de usuario) y la contraseña.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

EJEMPLO 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Bosque de destino. El valor predeterminado es el bosque del usuario que tiene una sesión iniciada actualmente.

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

La función usará las credenciales del usuario que tiene una sesión iniciada en el equipo, en lugar de solicitar las credenciales personalizadas del usuario.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-NetworkConnectivity

SINOPSIS

Detecta problemas de conectividad de la red local.

SINTAXIS

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

DESCRIPTION

Ejecuta pruebas de conectividad de la red local.

Para las pruebas de redes locales, Microsoft Entra Connect debe ser capaz de comunicarse con los controladores de dominio con nombre en los puertos 53 (DNS), 88 (Kerberos) y 389 (LDAP). La mayoría de las organizaciones ejecutan DNS en sus controladores de dominio, motivo por el que esta prueba está integrada actualmente. Si se ha especificado otro servidor DNS, se debe omitir el puerto 53.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

PARAMETERS

-DCs

Especifica los controladores de dominio en los que se realizará la prueba.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Si el usuario no usa los servicios DNS proporcionados por el controlador de dominio de inicio de sesión o el sitio de AD, es posible que prefiera omitir la comprobación del puerto 53. El usuario debe poder resolver _.ldap._tcp.<forestfqdn> para que la configuración del conector de Active Directory se realice correctamente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Devuelve el resultado de este diagnóstico en forma de objeto PSObject. No es necesario durante la interacción manual con esta herramienta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-TargetsAreReachable

SINOPSIS

Determina si un bosque especificado y sus controladores de dominio asociados son accesibles.

SINTAXIS

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

DESCRIPTION

Ejecuta pruebas de "ping" (si un equipo puede comunicarse con un equipo de destino a través de la red o de Internet)

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

PARAMETERS

-Forest

Especifica el nombre del bosque en el que se realizará la prueba.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica los controladores de dominio en los que se realizará la prueba.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidDomains

SINOPSIS

Validar que los dominios del FQDN del bosque obtenido sean accesibles

SINTAXIS

SamAccount

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

ForestFQDN

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

DESCRIPTION

Validar que todos los dominios del FQDN del bosque obtenido sean accesibles mediante un intento de recuperación de DomainGuid y DomainDN. Se pueden solicitar la cuenta (dominio\nombre de usuario) y la contraseña.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

EJEMPLO 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Bosque 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

La función usará las credenciales del usuario que tiene una sesión iniciada en el equipo, en lugar de solicitar las credenciales personalizadas del usuario.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ValidEnterpriseAdminCredentials

SINOPSIS

Validar si un usuario tiene credenciales de administrador de empresa.

SINTAXIS

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

DESCRIPTION

Busca si el usuario proporcionado tiene credenciales de administrador de empresa. Se pueden solicitar la cuenta (dominio\nombre de usuario) y la contraseña.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-RunWithCurrentlyLoggedInUserCredentials

La función usará las credenciales del usuario que tiene una sesión iniciada en el equipo, en lugar de solicitar las credenciales personalizadas del usuario.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-DomainFQDNData

SINOPSIS

Recupera un objeto DomainFQDN de una combinación de cuenta y contraseña.

SINTAXIS

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

DESCRIPTION

Intenta obtener un objeto domainFQDN de las credenciales proporcionadas. Si el objeto domainFQDN es válido, se devolverá DomainFQDNName RootDomainName, según la elección del usuario. Se pueden solicitar la cuenta (dominio\nombre de usuario) y la contraseña.

EJEMPLOS

EJEMPLO 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

EJEMPLO 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-DomainFQDNDataType

Tipo de datos deseado que se recuperará. Se limita actualmente 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 función usará las credenciales del usuario que tiene una sesión iniciada en el equipo, en lugar de solicitar las credenciales personalizadas del usuario.

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 por la función Start-NetworkConnectivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Get-ForestFQDN

SINOPSIS

Recupera un objeto ForestFQDN de una combinación de cuenta y contraseña.

SINTAXIS

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

DESCRIPTION

Intenta obtener un objeto ForestFQDN de las credenciales proporcionadas. Se pueden solicitar la cuenta (dominio\nombre de usuario) y la contraseña.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

PARAMETERS

-Forest

Bosque de destino. El valor predeterminado es el dominio del usuario que tiene una sesión iniciada actualmente.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La función usará las credenciales del usuario que tiene una sesión iniciada en el equipo, en lugar de solicitar las credenciales personalizadas del usuario.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-ConnectivityValidation

SINOPSIS

Función principal.

SINTAXIS

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

DESCRIPTION

Ejecuta todos los mecanismos disponibles que comprueban que las credenciales de AD sean válidas.

EJEMPLOS

EJEMPLO 1

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

PARAMETERS

-Forest

Bosque 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 instalaciones personalizadas: la marca es $True si el usuario selecciona "Crear una cuenta de AD" en la ventana Cuenta del bosque de AD del asistente de Microsoft Entra Connect. $False si el usuario elige "Usar una cuenta de AD existente". Para instalaciones rápidas: el valor de esta variable debe ser $True para las instalaciones rápidas.

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 rellena previamente el campo Nombre de usuario cuando se solicitan las credenciales del usuario.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Start-NetworkConnectivityDiagnosisTools

SINOPSIS

Función principal para las pruebas de conectividad de red.

SINTAXIS

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

DESCRIPTION

Ejecuta pruebas de conectividad de la red local.

EJEMPLOS

EJEMPLO 1

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

EJEMPLO 2

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

PARAMETERS

-Forest

Especifica el nombre del bosque en el que se realizará la prueba.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

Nombre de usuario y contraseña del usuario que está ejecutando la prueba. Requiere el mismo nivel de permisos que se requiere para ejecutar al Asistente de 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 la ubicación de un archivo de registro que contendrá la salida de esta función.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Especifica los controladores de dominio en los que se realizará la prueba.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Marca que permite mostrar un mensaje sobre el propósito de esta función.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Devuelve el resultado de este diagnóstico en forma de objeto PSObject. No es necesario que se especifique durante la interacción manual con esta herramienta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Indica si las credenciales que ha escrito el usuario son válidas. No es necesario que se especifique durante la interacción manual con esta herramienta.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).