Compartir a través de

Validación del registro de Azure

  • Artículo

Use la herramienta Azure Stack Hub Readiness Checker (AzsReadinessChecker) para validar que su suscripción de Azure está lista para usarse con Azure Stack Hub antes de comenzar la implementación correspondiente. La herramienta Readiness Checker valida que:

  • La suscripción de Azure que usa es de tipo compatible. Las suscripciones deben ser un proveedor de soluciones en la nube (CSP) o el contrato Enterprise (EA).
  • La cuenta que se usa para registrar la suscripción en Azure puede iniciar sesión en Azure y es propietaria de una suscripción.

Para más información sobre el registro de Azure Stack Hub, consulte Registro de Azure Stack Hub en Azure.

Obtención de la herramienta Readiness Checker

Descargue la versión más reciente de AzsReadinessChecker desde Galería de PowerShell.

Instalar y configurar

Requisitos previos

Se necesitan los siguientes requisitos previos:

Módulos Az de PowerShell

Tendrá que tener instalados los módulos Az de PowerShell. Para obtener instrucciones, consulte Instalación del módulo Az de PowerShell en versión preliminar.

Entorno de Microsoft Entra

  • Identifique el nombre de usuario y la contraseña de una cuenta con el rol de propietario de la suscripción de Azure que va a usar con Azure Stack Hub.
  • Indique el identificador de la suscripción de Azure que va a usar.

Pasos para validar el registro de Azure

  1. Abra un símbolo del sistema de PowerShell con privilegios elevados y ejecute el siguiente comando para instalar AzsReadinessChecker:

    Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2020-09-01-hybrid -Force
Install-Module -Name Microsoft.AzureStack.ReadinessChecker

  2. Desde el símbolo del sistema de PowerShell, ejecute el siguiente comando para establecer $subscriptionID como la suscripción de Azure que se va a usar. Reemplace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx por su propio identificador de suscripción:

    $subscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  3. En el símbolo del sistema de PowerShell, ejecute el siguiente comando:

    Connect-AzAccount -subscription $subscriptionID

  4. Desde el símbolo del sistema de PowerShell, ejecute el siguiente comando para iniciar la validación de la suscripción. Proporcione el administrador de Microsoft Entra y el nombre del inquilino de Microsoft Entra:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. Después de ejecutar la herramienta, revise el resultado. Confirme que el estado del inicio de sesión y los requisitos de instalación es correcto. Una salida de validación correcta tiene un aspecto similar al del siguiente ejemplo:

    Invoke-AzsRegistrationValidation v1.2100.1448.484 started.
Checking Registration Requirements: OK

Log location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Informe y archivo de registro

Cada vez que se ejecuta la validación, los resultados se registran en AzsReadinessChecker.log y AzsReadinessCheckerReport.json. La ubicación de estos archivos se muestra con los resultados de validación de PowerShell.

Estos archivos pueden ayudarle a compartir el estado de validación antes de implementar Azure Stack Hub o de investigar problemas de validación. Ambos archivos conservan los resultados de cada comprobación de validación posterior. El informe ofrece la confirmación del equipo de implementación de la configuración de identidad. El archivo de registro puede ayudar al equipo de implementación o de soporte técnico a investigar los problemas de validación.

De forma predeterminada, ambos archivos se escriben en C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Use el parámetro -OutputPath <path> al final de la línea de comandos de ejecución para especificar otra ubicación para el informe.
  • Use el parámetro -CleanReport al final del comando de ejecución para borrar la información de ejecuciones anteriores de la herramienta desde AzsReadinessCheckerReport.json.

Para más información, consulte Informe de validación para Azure Stack Hub.

Errores de validación

Si se producen errores en una comprobación de validación, los detalles sobre los errores se muestran en la ventana de PowerShell. La herramienta también registra información en el archivo AzsReadinessChecker.log.

Los ejemplos siguientes ofrecen más información sobre los errores de validación comunes:

El usuario que llama debe ser propietario de la suscripción.

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
The user admin@contoso.onmicrosoft.com is role(s) Reader for subscription 3f961d1c-d1fb-40c3-99ba-44524b56df2d. User must be an owner of the subscription to be used for registration.
Additional help URL https://aka.ms/AzsRemediateRegistration

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Causa: la cuenta no es un administrador de la suscripción de Azure.

Resolución: use una cuenta que tenga un rol de administrador de la suscripción de Azure en la que el uso se facturará a partir de la implementación de Azure Stack Hub.

Contraseña temporal o expirada

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription [subscription ID] using account admin@contoso.onmicrosoft.com failed with AADSTS50055: Force Change Password.
Trace ID: [Trace ID]
Correlation ID: [Correlation ID]
Timestamp: 2018-10-22 11:16:56Z: The remote server returned an error: (401) Unauthorized.

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Causa: la cuenta no puede iniciar sesión porque la contraseña es temporal o ha expirado.

Resolución: en PowerShell, ejecute el siguiente comando y siga los avisos para restablecer la contraseña.

Login-AzureRMAccount

O bien, inicie sesión en Azure Portal como propietario de la cuenta y el usuario se verá obligado a cambiar la contraseña.

Tipo de usuario desconocido

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription <subscription ID> using <account> failed with unknown_user_type: Unknown User Type

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Causa: la cuenta no puede iniciar sesión en el entorno de Microsoft Entra especificado. En este ejemplo, AzureChinaCloud se especifica como valor de AzureEnvironment.

Resolución: confirme que la cuenta es válida para el entorno de Azure especificado. En PowerShell, ejecute el siguiente comando para comprobar que la cuenta es válida para un entorno concreto:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

Pasos siguientes