Устранение неполадок с локальными виртуальными машинами Azure, включенными в Azure Arc

2025-07-07

Область применения: Azure Local 2311.2 и более поздних версий

В этой статье описывается, как собирать журналы и устранять проблемы с локальными виртуальными машинами Azure, включенными Azure Arc. В нем также перечислены текущие ограничения и известные проблемы с управлением локальными виртуальными машинами Azure, а также рекомендуемые решения.

Свойство не поддерживается для этой операции

Ошибка.

Property '<Property Name>' isn't supported for this operation on your Azure Local cluster version. Please update your cluster if you want to set this property for this operation. Please view aka.ms/hciproperties.

Причина.

Эта ошибка возникает, когда функция, которую вы пытаетесь использовать, недоступна для версии программного обеспечения, работающей в локальном экземпляре Azure. Это может произойти, если версия программного обеспечения в кластере устарела или функция появилась в более поздней версии.

Резолюция:

Чтобы устранить эту проблему, обновите локальный экземпляр Azure до последней версии. Дополнительные сведения см. в статье "Обновление с помощью PowerShell " или "Обновление" с помощью портала Azure.

Расширение кластера не поддерживает тип ресурса

Ошибка.

The cluster extension '<Cluster Extension Azure Resource Manager ID>' doesn't support resource type 'Microsoft.AzureStackHCI/<Resource Type>'. The currently enabled resource types are '<Supported Resource Type Names>'. Please ensure the 'Microsoft.AzureStackHCI' cluster extension version metadata file supports the resource type. [ClusterExtensionVersion='<Cluster Extension Version>'] [CorrelationId='<Correlation ID>'].

Причина.

Резолюция:

Не удается выбрать образ для доверенных виртуальных машин запуска

Доверенный запуск для локальных виртуальных машин Azure в настоящее время поддерживает только набор образов Azure Marketplace. Список поддерживаемых образов см. в разделе "Образы гостевой операционной системы". При создании доверенной виртуальной машины запуска на портале Azure раскрывающийся список образов отображает только образы, поддерживаемые доверенным запуском. В раскрывающемся списке "Изображение" отображается пусто, если выбран неподдерживаемый образ, включая пользовательский образ. Список также отображается пустым, если ни один из образов, доступных в локальной системе Azure, не поддерживается доверенным запуском.

Сбой при попытке включить управление гостевыми клиентами

При попытке выполнить команду для включения гостевого управления вы увидите следующую ошибку:

Ошибка:Deployment failed. Correlation ID: aaaa0000-bb11-2222-33cc-444444dddddd. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

Эта ошибка произошла из-за того, что управляемое удостоверение не было создано для этой виртуальной машины. Для включения управления гостями требуется управляемое удостоверение, назначенное системой.

Резолюция:

Выполните следующие действия, чтобы убедиться, что управляемое удостоверение не создано для этой виртуальной машины, а затем включите управляемое удостоверение, назначаемое системой.

В портале Azure перейдите к виртуальной машине. Перейдите на страницу обзора . На вкладке "Свойства" в разделе "Конфигурация"управление гостевыми клиентами должно отображаться как "Отключено". Выберите представление JSON в правом верхнем углу.
Под параметром Identitytype должно отображаться как None.
Чтобы создать управляемое удостоверение, подключитесь к локальному компьютеру Azure с помощью протокола удаленного рабочего стола (RDP). Выполните следующую команду:
```
az extension add --name connectedmachine
```

Убедитесь, что в системе установлено расширение CLI подключенного компьютера. Ниже приведен пример выходных данных с успешно установленным расширением. connectedmachine указывает, что установлена версия 0.7.0.

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2",
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": "0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

Выполните следующую команду, чтобы назначить управляемое системой удостоверение виртуальной машине.
```
az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
```
Перейдите на портал Azure и перейдите на страницу обзора . Представление JSON должно указывать, что системная управляемая идентификация теперь назначена виртуальной машине.

Сбой при развертывании образа виртуальной машины из учетной записи хранения

При попытке развернуть образ виртуальной машины из учетной записи хранения в локальной среде Azure возникает следующая ошибка:

Ошибка:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n"}

Вы увидите следующее сообщение об ошибке:

Ошибка:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n"}

Сбой возникает, так как пользователь, создающий образ, не имеет необходимых разрешений для доступа к образу из учетной записи хранения. Пользователь должен иметь роль вкладчика данных для BLOB-объектов в учетной записи хранения, которую вы используете для образа. Дополнительные сведения см. в статье "Назначение ролей Azure для доступа к данным BLOB-объектов".

Резолюция:

Добавьте пользователю, которому нужно создать образ из этой учетной записи хранения, роль "Участник данных BLOB-объектов хранилища". После добавления роли повторите развертывание образа.

При попытке развернуть образ виртуальной машины из учетной записи хранения данных может появиться следующая ошибка:

Ошибка:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","additionalInfo":[{"type":"ErrorInfo","info":{"category":"Uncategorized","recommendedAction":"","troubleshootingURL":""}}]}

Эта ошибка возникает из-за того, что тип блоба в учетной записи хранения неправильный. Изображение должно иметь page blob тип.

Резолюция:

Загрузите образ в учетную запись для хранения в page blob format и повторите развертывание образа.

Убедитесь, что у пользователя есть правильные разрешения, и blob находится в правильном формате. Дополнительные сведения см. в статье "Добавление образа виртуальной машины из учетной записи хранения Azure".

Сбой при развертывании локальной виртуальной машины Azure

При попытке развернуть локальную виртуальную машину Azure возникает следующая ошибка:

Ошибка:{"code":"ConflictingOperation","message":"Unable to process request 'Microsoft.AzureStackHCI/virtualMachineInstances'. There is already a previous running operation for resource '/subscriptions/<subscription ID>/resourceGroups/<Resource group name>/providers/Microsoft.HybridCompute/machines/<VM name>/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default'. Please wait for the previous operation to complete."}

Эта ошибка возникает, потому что объект управляемого удостоверения SystemAssigned не принадлежит к типу ресурса Microsoft.HybridCompute/machines.

Резолюция:

Проверьте в шаблоне развертывания следующее:

Объект SystemAssigned управляемого удостоверения находится в Microsoft.HybridCompute/machines типе ресурса, а не в Microsoft.AzureStackHCI/VirtualMachineInstances типе ресурса.

Шаблон развертывания должен соответствовать предоставленному образцу шаблона. Дополнительные сведения см. в примере шаблона в статье "Создание локальных виртуальных машин Azure" с поддержкой Azure Arc.

Установка Azure CLI не распознана

Если после установки среды не удается распознать Azure CLI, выполните следующий блок кода, чтобы добавить путь установки Azure CLI в путь к среде.

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

При запуске появляется сообщение "Windows создала временный файл подкачки"

Ошибка.

При развертывании локальной виртуальной машины Azure с помощью SQL Server 2022 на образах Windows Server 2022 Azure Marketplace (цен. категория "Стандартный" или "Корпоративный") может появиться следующее предупреждение при запуске:

Windows создал временный файл разбиения по страницам...

Резолюция:

Проблему можно устранить следующим способом.

Нажмите OK в появившемся предупреждении. Или перейдите в "Свойства системы>Дополнительно>Производительность>Настройки", чтобы открыть окно "Параметры производительности>".
В окне "Параметры производительности " выберите "Изменить" в разделе "Виртуальная память ".
В окне виртуальной памяти выберите управляемый системой размер.  Кроме того, убедитесь, что флажок " Автоматически управлять файлами разбиения на страницы" для всех дисков снят.
Нажмите кнопку "Задать", а затем нажмите кнопку "ОК ", чтобы применить изменения.
Перезапустите виртуальную машину. После перезапуска сообщение предупреждения больше не должно отображаться.