Microsoft Entra Connect: Referencia de PowerShell ADConnectivityTools
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).
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de