Solucionar problemas de provisionamento de computador simplificado para implantações hiperconvergadas de Azure Local (versão prévia)

Importante

Esse recurso está em VERSÃO PRÉVIA no momento. Consulte os Termos Suplementares de Uso para visualizações do Microsoft Azure para termos legais que se aplicam a recursos do Azure que estão em versão beta, prévia ou ainda não liberados para disponibilidade geral para o público.

Este artigo descreve como solucionar problemas de provisionamento simplificado do computador. Você pode usar os seguintes métodos para solucionar problemas:

Execute testes de diagnóstico.
Colete um pacote de suporte.
Colete logs da sua assinatura do Azure.

Executar testes de diagnóstico do aplicativo Configurator

Para diagnosticar e solucionar problemas de dispositivo relacionados ao hardware, ao servidor de tempo e à rede, você pode executar os testes de diagnóstico. Siga estas etapas para executar os testes de diagnóstico do aplicativo:

Selecione o ícone de ajuda no canto superior direito do aplicativo para abrir Suporte + solução de problemas.
Selecione Executar testes de diagnóstico. Os testes de diagnóstico verificam a integridade do hardware do servidor, do servidor de tempo e da conectividade de rede. Os testes também verificam o status do agente Azure Arc e as extensões.
Depois que os testes são concluídos, os resultados são exibidos. Resolva os problemas e repita a operação.

Coletar um pacote de suporte do aplicativo

Um pacote de log é composto por todos os logs relevantes que podem ajudar o Suporte da Microsoft a solucionar problemas de dispositivo. Você pode gerar um pacote de log por meio da interface web local. Siga estas etapas para coletar um pacote de suporte do aplicativo:

Selecione o ícone de ajuda no canto superior direito do aplicativo para abrir Suporte + solução de problemas.
Selecione Criar para iniciar a coleção de pacotes de suporte. A coleção de pacotes pode levar vários minutos.
Depois que o pacote de suporte for criado, selecione Baixar. Um pacote compactado é baixado em seu sistema local. Você pode descompactar o pacote e exibir os arquivos de log do sistema.

Coletar os logs de sua assinatura do Azure

Se você não conseguir acessar o computador usando o aplicativo Configurator, poderá obter os logs do aplicativo do servidor. Acesse os logs conectando-se ao PowerShell.

Os logs são armazenados nos seguintes locais:

Sistema operacional de destino	Arquivos de log
Azure Stack HCI	`C:\Windows\System32\Bootstrap\Logs`
Ambiente de manutenção	`/var/log/bootstrap` `/var/log/provisioningextension` `/var/log/trident-full.log` `/var/log/messages` `/var/log/bootstraprestservice`

Problema persistente de loop de inicialização USB com o ambiente de manutenção

Problema: A inicialização USB entrará em uma sequência de inicialização USB infinita se as Configurações do BIOS estiverem definidas Boot USB Devices First no computador.

Causa:

Quando a configuração Boot USB Devices First do BIOS está habilitada no computador, o sistema insere um ciclo de inicialização USB infinito. Essa configuração substitui a ordem de inicialização configurada e sempre prioriza a inicialização de qualquer dispositivo USB conectado. Como resultado, mesmo depois que o ambiente de manutenção é instalado com êxito, as reinicializações subsequentes continuam a ser inicializadas da mídia USB em vez do disco interno.

Esse comportamento causa um loop de inicialização contínuo no qual o dispositivo repetidamente:

Inicializa a partir do dispositivo USB.
Reinstala o ambiente de manutenção.
Reinicia.

Do ponto de vista do cliente, o dispositivo parece estar em um ciclo infinito de instalação e reinicialização, que ocorre aproximadamente a cada 10 minutos.

Recomendação:

Você só precisa inicializar de um dispositivo USB uma vez para instalar o ambiente de manutenção. Depois disso, você deve configurar o computador para inicializar do disco interno. Para obter mais informações, consulte Preparar computadores. Para obter instruções sobre como acessar o menu de inicialização ou alterar a ordem de inicialização do computador, verifique a documentação que veio com seu computador ou vá para o site do fabricante.

A lista suspensa de imagens do sistema operacional está vazia

Problema: No portal Azure, selecione Azure ArcOperaçõesProvisionamento de máquina (pré-visualização)ComeçarProvisionar. Na página Provisionar novos computadores, a lista suspensaimagem do > operacional está vazia.

Cause: O registro do provedor de recursos para Microsoft.AzureStackHCI está ausente.

Recomendação: Registre o provedor de recursos conforme descrito nos pré-requisitos.

Quando você provisiona novos computadores, a validação do modelo do ARM falha

Problem: No portal Azure, selecione Azure Arc>Operações>Provisionamento de Máquina (prévia)>Começar>Provisionar. Na página Provisionar novos computadores , ao selecionar Criar, você verá as mensagens Arm template validation failed de erro e 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: Esse problema poderá ocorrer se você estiver usando Azure Stack HCI pela primeira vez nesta assinatura.

Recomendação:

Exclua o computador provisionado. Selecione Azure Arc>Operações>Provisionamento de máquinas (versão prévia)>Máquinas provisionadas. Selecione o computador e, em seguida, selecione Excluir.
Aguarde 15 minutos.
Selecione Azure Arc>Operations>Provisionamento de Máquina (versão prévia)>Iniciar>Provisionar. Carregue o voucher e provisione o computador novamente. Para obter mais informações, consulte Provisionar computadores de Azure.

Ao provisionar novos computadores, você recebe um erro interno do servidor

Problema: No portal do Azure, selecione Azure Arc>Operações>Provisionamento de máquinas (pré-visualização)>Introdução>Provisionar. Na página Provisionar novos computadores , ao selecionar Criar, você verá as mensagens The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'. de erro e Failed to verify creation of MoboBroker resource. (Code: InternalServerError)

Causes: Seu administrador configurou um Azure Policy que inclui um ou mais dos seguintes requisitos:

Os grupos de recursos devem ser criados em uma região específica. Nesta versão prévia, somente a região eastus dá suporte ao provisionamento simplificado de máquina.
Os grupos de recursos devem ser criados usando uma convenção de nomenclatura específica.
Os recursos devem ter marcas Azure Resource Manager. Atualmente, o provisionamento simplificado de computador não dá suporte a esse requisito.

Recomendações:

No portal do Azure, navegue até o grupo de recursos em que você está tentando provisionar novos computadores e selecione Monitor>Log de atividades. Você pode usar o log de atividades para investigar o erro de provisionamento e determinar qual Azure Policy está restringindo a criação de recursos. Para obter mais informações, consulte Log de atividade no Azure Monitor.
Adicione uma isenção da Azure Policy para a política que está em conflito com o provisionamento simplificado de máquinas.
Se o erro for devido ao nome do MRG (Grupo de Recursos Gerenciados), você poderá resolvê-lo definindo o nome mrg durante o provisionamento. Depois de selecionar o site, selecione Configure e, em seguida, defina o nome MRG de acordo com a Azure Policy do cliente. Nesta versão prévia, apenas a região eastus suporta MRGs.
Exclua o computador provisionado. Selecione Azure Arc>Operações>Provisionamento de máquinas (versão prévia)>Máquinas provisionadas. Selecione o computador e, em seguida, selecione Excluir.
Selecione Azure Arc>Operations>Machine provisioning (versão prévia)>Começar>Provision. Carregue o voucher e provisione o computador novamente. Para obter mais informações, consulte Provisionar computadores de Azure.

Tente novamente o provisionamento falho do sistema operacional

Problema: Se a instalação do sistema operacional falhar, a página de implantações mostrará as mensagens Your deployment failed de erro e The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'. o provisionamento simplificado do computador atualmente não oferecerá suporte a novas tentativas automáticas do serviço caso a instalação do sistema operacional falhe.

Recomendação:

Para tentar novamente o provisionamento do sistema operacional:

Navegue até Azure Cloud Shell.
Azure solicitará que você escolha Bash ou PowerShell se ainda não tiver selecionado um padrão. Ele também pode solicitar que você crie ou selecione uma conta de armazenamento para persistir seus arquivos de Cloud Shell.

Crie e execute o script Bash a seguir. Substitua <PLACEHOLDERS> pelos seus 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"

Leva até 30 minutos para a repetição ser concluída.

Comentários

Esta página foi útil?

Última atualização em 2026-09-15

Solucionar problemas de provisionamento de computador simplificado para implantações hiperconvergadas de Azure Local (versão prévia)

Executar testes de diagnóstico do aplicativo Configurator

Coletar um pacote de suporte do aplicativo

Coletar os logs de sua assinatura do Azure

Problema persistente de loop de inicialização USB com o ambiente de manutenção

A lista suspensa de imagens do sistema operacional está vazia

Quando você provisiona novos computadores, a validação do modelo do ARM falha

Ao provisionar novos computadores, você recebe um erro interno do servidor

Tente novamente o provisionamento falho do sistema operacional

Comentários

Recursos adicionais