Solución de problemas de aprovisionamiento simplificado de máquinas para implementaciones hiperconvergidas de Azure Local (versión preliminar)

Importante

Esta característica actualmente está en VERSIÓN PRELIMINAR. Consulte los términos Supplementales de uso para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en versión beta, versión preliminar o, de lo contrario, aún no se han publicado en disponibilidad general.

En este artículo se describe cómo solucionar problemas de aprovisionamiento simplificado de máquinas. Puede usar los métodos siguientes para solucionar problemas:

Ejecute pruebas de diagnóstico.
Recopile un paquete de soporte técnico.
Recoja registros de su suscripción de Azure.

Ejecución de pruebas de diagnóstico desde la aplicación Configurator

Para diagnosticar y solucionar cualquier problema de dispositivo relacionado con el hardware, el servidor de hora y la red, puede ejecutar las pruebas de diagnóstico. Siga estos pasos para ejecutar las pruebas de diagnóstico desde la aplicación:

Seleccione el icono de ayuda en la esquina superior derecha de la aplicación para abrir Soporte técnico y solución de problemas.
Seleccione Ejecutar pruebas de diagnóstico. Las pruebas de diagnóstico comprueban el estado del hardware del servidor, el servidor de hora y la conectividad de red. Las pruebas también comprueban el estado del agente de Azure Arc y las extensiones.
Una vez completadas las pruebas, se muestran los resultados. Resuelva los problemas y vuelva a intentar la operación.

Recoge un paquete de soporte técnico de la aplicación

Un paquete de registro se compone de todos los registros pertinentes que pueden ayudar a Soporte técnico de Microsoft solucionar cualquier problema del dispositivo. Puede generar un paquete de registro a través de la interfaz de usuario web local. Siga estos pasos para recopilar un paquete de soporte técnico de la aplicación:

Seleccione el icono de ayuda en la esquina superior derecha de la aplicación para abrir Soporte técnico y solución de problemas.
Seleccione Crear para iniciar la recopilación del paquete de soporte. La recopilación de paquetes puede tardar varios minutos.
Una vez creado el paquete de soporte técnico, seleccione Descargar. Un paquete comprimido se descarga en el sistema local. Puede descomprimir el paquete y ver los archivos de registro del sistema.

Recopila registros desde tu suscripción de Azure

Si no puede acceder a la máquina mediante la aplicación Configurator, puede obtener los registros de la aplicación desde el servidor. Acceda a los registros mediante la conexión con PowerShell.

Los registros se almacenan en las siguientes ubicaciones:

Sistema operativo de destino	Archivos de registro
Azure Stack HCI	`C:\Windows\System32\Bootstrap\Logs`
Entorno de mantenimiento	`/var/log/bootstrap` `/var/log/provisioningextension` `/var/log/trident-full.log` `/var/log/messages` `/var/log/bootstraprestservice`

Problema de bucle de arranque de USB en el entorno de mantenimiento

Problema: El arranque USB entra en una secuencia de arranque USB infinita si la configuración Boot USB Devices First del BIOS está establecida en la máquina.

Causa:

Cuando la configuración Boot USB Devices First del BIOS está habilitada en la máquina, el sistema entra en un ciclo de arranque USB infinito. Esta configuración invalida el orden de arranque configurado y siempre prioriza el arranque desde cualquier dispositivo USB conectado. Como resultado, incluso después de instalar correctamente el entorno de mantenimiento, los reinicios posteriores continúan arrancando desde el medio USB en lugar del disco interno.

Este comportamiento provoca un bucle de arranque continuo en el que el dispositivo repetidamente:

Arranca desde el dispositivo USB.
Vuelve a instalar el entorno de mantenimiento.
Reinicia.

Desde la perspectiva del cliente, el dispositivo parece estar en un ciclo infinito de instalación y reinicio, que se produce aproximadamente cada 10 minutos.

Recomendación:

Solo tiene que arrancar desde un dispositivo USB una vez para instalar el entorno de mantenimiento. Después, debe configurar la máquina para que arranque desde el disco interno. Para obtener más información, consulte Preparación de máquinas. Para obtener instrucciones sobre cómo acceder al menú de arranque o cambiar el pedido de arranque de la máquina, consulte la documentación que se incluye con la máquina o vaya al sitio web del fabricante.

La lista desplegable de imágenes del sistema operativo está vacía

Problem: En el portal de Azure, seleccione Azure Arc>Operations>Aprovisionamiento de máquinas (versión preliminar)>Comenzar>Aprovisionar. En la página Aprovisionamiento de nuevas máquinas, la lista desplegableImagen del > operativo está vacía.

Cause: Falta el registro del proveedor de recursos para Microsoft.AzureStackHCI.

Recomendación: Registre el proveedor de recursos como se describe en los requisitos previos.

Al aprovisionar nuevas máquinas, se produce un error en la validación de plantillas de ARM.

Problem: En el portal de Azure, seleccione Azure Arc>Operaciones>Aprovisionamiento de máquinas (versión preliminar)>Comenzar>Aprovisionar. En la página Aprovisionar nuevas máquinas , al seleccionar Crear, verá los mensajes Arm template validation failed de error y Deployment template validation failed: 'The value for the template parameter 'hciRPServiceprincipalID' at line '1' and column '10174' is not provided. Please see https://aka.ms/arm-create-parameter-file for usage details.'. (Code: InvalidTemplate)

Cause: Este problema puede ocurrir si usa Azure Stack HCI por primera vez en esta suscripción.

Recomendación:

Elimine la máquina aprovisionada. Seleccione Azure Arc>Operaciones>aprovisionamiento de máquinas (versión preliminar)>Máquinas aprovisionadas. Seleccione la máquina y, a continuación, seleccione Eliminar.
Espere 15 minutos.
Seleccione Azure Arc>Operations>Aprovisionamiento de Machine (vista previa)>Comenzar>Aprovisionar. Cargue el vale y vuelva a aprovisionar la máquina. Para obtener más información, consulte Provision machines from Azure.

Al aprovisionar nuevas máquinas, se produce un error interno del servidor.

Problema: En el portal de Azure, seleccione Azure Arc>Operaciones>Aprovisionamiento de máquinas (versión preliminar)>Comenzar>Aprovisionar. En la página Aprovisionar nuevas máquinas , al seleccionar Crear, verá los mensajes The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'. de error y Failed to verify creation of MoboBroker resource. (Code: InternalServerError)

Causes: El administrador ha configurado un Azure Policy que incluye uno o varios de los siguientes requisitos:

Los grupos de recursos deben crearse en una región específica. En esta versión preliminar, solo la región eastus admite el aprovisionamiento simplificado de máquinas.
Los grupos de recursos se deben crear mediante una convención de nomenclatura específica.
Los recursos deben tener etiquetas Azure Resource Manager. El aprovisionamiento simplificado de máquinas no admite actualmente este requisito.

Recomendaciones:

En Azure portal, vaya al grupo de recursos donde intenta aprovisionar nuevas máquinas y seleccione Monitor>Registro de actividad. Puede usar el registro de actividad para investigar el error de aprovisionamiento y determinar qué Azure Policy restringe la creación de recursos. Para obtener más información, consulte el Registro de actividades en Azure Monitor.
Agregue una exención Azure Policy para la directiva que entra en conflicto con el aprovisionamiento simplificado de máquinas.
Si el error se debe al nombre del grupo de recursos administrado (MRG), puede resolverlo estableciendo el nombre de MRG durante el aprovisionamiento. Después de seleccionar el sitio, seleccione Configure y, a continuación, establezca el nombre de MRG para que se ajuste al Azure Policy del cliente. En esta versión preliminar, solo la eastus región admite MRG.
Elimine la máquina aprovisionada. Seleccione Azure Arc>Operaciones>Aprovisionamiento de máquinas (preview)>Máquinas aprovisionadas. Seleccione la máquina y, a continuación, seleccione Eliminar.
Seleccione Azure Arc>Operations>Aprovisionamiento de Machine (versión preliminar)>Comenzar>Aprovisionar. Cargue el vale y vuelva a aprovisionar la máquina. Para obtener más información, consulte Provision machines from Azure.

Volver a intentar un aprovisionamiento fallido del sistema operativo

Problema: Si se produce un error en la instalación del sistema operativo, la página implementaciones muestra los mensajes Your deployment failed de error y The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'. el aprovisionamiento simplificado de máquinas actualmente no admite reintentos automáticos desde el servicio en caso de que se produzca un error en la instalación del sistema operativo.

Recomendación:

Para reintentar el aprovisionamiento del sistema operativo:

Vaya a Azure Cloud Shell.
Azure le pide que elija Bash o PowerShell si aún no ha seleccionado un valor predeterminado. También puede pedir que cree o seleccione una cuenta de almacenamiento para conservar los archivos de Cloud Shell.

Cree y ejecute el siguiente script de Bash. Reemplace el <PLACEHOLDERS> por sus valores.

#!/bin/bash
set -e

# Script to retry OS provisioning on an edge machine by resubmitting the ProvisionOS job
# Performs a reput with osProfile and userDetails

# Input parameters
SUBSCRIPTION_ID=<subscription-id> 
RESOURCE_GROUP=<resource-group>
PROVISIONED_MACHINE_NAME=edge-machine-name>

# Validate inputs
if [ -z "$SUBSCRIPTION_ID" ] || [ -z "$RESOURCE_GROUP" ] || [ -z "$PROVISIONED_MACHINE_NAME" ]; then
    echo "Usage: $0 <subscription-id> <resource-group> <edge-machine-name>"
    exit 1
fi

echo "Subscription ID: $SUBSCRIPTION_ID"
echo "Resource Group: $RESOURCE_GROUP"
echo "Edge Machine Name: $PROVISIONED_MACHINE_NAME"

# Set the subscription
echo "Setting subscription..."
az account set --subscription "$SUBSCRIPTION_ID"

# Construct the ProvisionOS job endpoint
PROVISION_OS_URL="/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.AzureStackHCI/edgeMachines/$PROVISIONED_MACHINE_NAME/jobs/ProvisionOs"
EDGE_MACHINE_URL="/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.AzureStackHCI/edgeMachines/$PROVISIONED_MACHINE_NAME"
API_VERSION="2025-12-01-preview"

echo "Getting edge machine configuration..."
# GET the edge machine to extract userDetails
EDGE_MACHINE_CONFIG=$(az rest \
    --method GET \
    --url "https://management.azure.com${EDGE_MACHINE_URL}?api-version=${API_VERSION}" \
    --output json)

echo "Edge machine configuration retrieved"

# Extract userDetails and osProfile from edge machine
USER_DETAILS=$(echo "$EDGE_MACHINE_CONFIG" | jq '.properties.provisioningDetails.userDetails')
OS_PROFILE=$(echo "$EDGE_MACHINE_CONFIG" | jq '.properties.provisioningDetails.osProfile')
SITE_RESOURCE_ID=$(echo "$EDGE_MACHINE_CONFIG" | jq -r '.properties.siteDetails.siteResourceId')

if [ "$USER_DETAILS" == "null" ] || [ "$OS_PROFILE" == "null" ]; then
    echo "Error: Could not extract userDetails or osProfile from the edge machine configuration"
    echo "Edge machine config: $EDGE_MACHINE_CONFIG"
    exit 1
fi

# Hardcode target and jobType
TARGET="HCI"
JOB_TYPE="ProvisionOs"

echo "Extracted osProfile and userDetails from edge machine; using hardcoded target: $TARGET and jobType: $JOB_TYPE"

# Create the PUT body with osProfile, userDetails, target, and jobType
PUT_BODY=$(jq -n \
    --argjson osProfile "$OS_PROFILE" \
    --argjson userDetails "$USER_DETAILS" \
    --arg target "$TARGET" \
    --arg jobType "$JOB_TYPE" \
    '{
        properties: {
            jobType: $jobType,
            provisioningRequest: {
                osProfile: $osProfile,
                userDetails: $userDetails,
                target: $target
            }
        }
    }')

echo "Performing reput to retry OS provisioning..."
# PUT the configuration back to trigger a retry
az rest \
    --method PUT \
    --url "https://management.azure.com${PROVISION_OS_URL}?api-version=${API_VERSION}" \
    --body "$PUT_BODY" \
    --output json

echo "ProvisionOS retry submitted successfully"

El reintento tarda hasta 30 minutos en completarse.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-08-24

Solución de problemas de aprovisionamiento simplificado de máquinas para implementaciones hiperconvergidas de Azure Local (versión preliminar)

Ejecución de pruebas de diagnóstico desde la aplicación Configurator

Recoge un paquete de soporte técnico de la aplicación

Recopila registros desde tu suscripción de Azure

Problema de bucle de arranque de USB en el entorno de mantenimiento

La lista desplegable de imágenes del sistema operativo está vacía

Al aprovisionar nuevas máquinas, se produce un error en la validación de plantillas de ARM.

Al aprovisionar nuevas máquinas, se produce un error interno del servidor.

Volver a intentar un aprovisionamiento fallido del sistema operativo

Comentarios

Recursos adicionales