使用現有的 Arc VM 建立 Azure Stack HCI VM 映像
適用於:Azure Stack HCI 版本 23H2
本文說明如何透過 Azure CLI 使用現有的 Arc VM,為您的 Azure Stack HCI 建立虛擬機 (VM) 映射。 Arc VM 的作業系統 (OS) 磁碟可用來在 Azure Stack HCI 上建立資源庫映射。
必要條件
在您開始前,請確定:
- 您已檢閱並完成 Arc VM管理必要條件。
- 您已使用透過 Azure CLI 用戶端連線到 Azure Stack HCI 中的指示來連線到 Azure Stack HCI。
從現有的 Arc VM 建立 VM 映像
您可以從 Arc VM 的 OS 磁碟建立 VM 映射,然後使用此映射在 Azure Stack HCI 上部署 VM。
請遵循下列步驟,使用 Azure CLI 建立 VM 映射。
登入並設定訂用帳戶
線上到 Azure Stack HCI 系統上的伺服器。
登入。 輸入:
az login --use-device-code
設定您的訂用帳戶。
az account set --subscription <Subscription ID>
設定一些參數
為您的訂用帳戶、資源群組、位置、本機共用中的映射路徑,以及映像的OS類型設定。 將中的 < >
參數取代為適當的值。
$subscription = "<Subscription ID>"
$resource_group = "<Resource group>"
$location = "<Location for your Azure Stack HCI>"
$custom_location = "<Custom location for your Azure Stack HCI>"
$osType = "<OS of source VM>"
$imageName = "<VM image name>"
$sourceVmName = "<Name of source VM in the Storage account>"
下表會說明這些參數:
參數 | 描述 |
---|---|
subscription |
您與此映像相關聯的 Azure Stack HCI 叢集訂用帳戶。 |
resource_group |
您與此映像相關聯的 Azure Stack HCI 叢集資源群組。 |
location |
Azure Stack HCI 叢集的位置。 例如,可以是 eastus 。 |
custom-location |
Azure Stack HCI 叢集的自定義位置識別碼。 |
name |
從本機共用中的映像開始建立的 VM 映像名稱。 注意:Azure 會拒絕包含關鍵詞 Windows 的所有名稱。 |
source-vm |
您將用來建立 VM 映像的現有 Arc VM 名稱。 |
os-type |
與來源映像相關聯的操作系統。 這可以是 Windows 或 Linux。 |
以下是範例輸出:
PS C:\Users\azcli> $subscription = "mysub-id"
PS C:\Users\azcli> $resource_group = "myhci-rg"
PS C:\Users\azcli> $location = "eastus"
PS C:\Users\azcli> $custom_location = "myhci-cl"
PS C:\Users\azcli> $osType = "Windows"
PS C:\Users\azcli> $imageName = "myhci-image"
PS C:\Users\azcli> $sourceVmName = "mysourcevm"
從 Arc VM 建立 VM 映像
從現有的 Arc VM 建立 VM 映像。 執行以下命令:
az stack-hci-vm image create -resource-group $resource_group --location $location --custom-location $custom_location --os-type $osType --source-vm $sourceVmName --name $imageName
VM 映射開始部署作業。 映像部署需要數分鐘的時間才能完成。
以下是範例輸出:
{
"extendedLocation": {
"name": "/subscriptions/mysub-id/resourceGroups/myhci-rg/providers/Microsoft.ExtendedLocation/customLocations/myhci-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/mysub-id/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryImages/myhci-image",
"location": "eastus",
"name": "myhci-image",
"properties": {
"cloudInitDataSource": null,
"containerId": null,
"hyperVGeneration": null,
"identifier": null,
"imagePath": null,
"osType": "Windows",
"provisioningState": "Succeeded",
"sourceVirtualMachineId": "/subscriptions/mysub-id/resourceGroups/myhci-rg/providers/Microsoft.HybridCompute/machines/mysourcevm/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default",
"status": {
"downloadStatus": {
"downloadSizeInMb": null
},
"errorCode": "",
"errorMessage": "",
"progressPercentage": null,
"provisioningStatus": {
"operationId": null,
"status": null
}
},
"version": {
"name": null,
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMb": null
}
}
}
}
},
"resourceGroup": "myhci-rg",
"systemData": {
"createdAt": "2024-09-26T20:16:17.625002+00:00",
"createdBy": "a5e473cb-e3e7-4035-b4da-290a65350ae1",
"createdByType": "Application",
"lastModifiedAt": "2024-09-26T20:16:17.625002+00:00",
"lastModifiedBy": "a5e473cb-e3e7-4035-b4da-290a65350ae1",
"lastModifiedByType": "Application"
},
"tags": null,
"type": "microsoft.azurestackhci/galleryimages"
}
列出 VM 映像
您必須檢視 VM 映射清單,以選擇要管理的映像。
請遵循下列步驟,使用 Azure CLI 列出 VM 映射。
以系統管理員身分執行 PowerShell。
設定部分參數。
$subscription = "<Subscription ID associated with your cluster>" $resource_group = "<Resource group name for your cluster>"
列出與您的叢集相關聯的所有 VM 映像。 執行以下命令:
az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
根據所使用的命令,會列出一組與 Azure Stack HCI 叢集相關聯的對應映像。
- 如果您只指定訂用帳戶,命令會列出訂用帳戶中的所有映像。
- 如果您同時指定訂用帳戶和資源群組,命令會列出資源群組中的所有映像。
這些映像包括:
- 來自市集映像的 VM 映像。
- 位於您 Azure 儲存體 帳戶中的自定義映像,或位於叢集或連線至叢集的用戶端上的本機共用中。
以下是範例輸出。
PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "myhci-rg"
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[
{
"extendedLocation": {
"name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/microsoft.azurestackhci/marketplacegalleryimages/w
inServer2022Az-01",
"location": "eastus",
"name": "winServer2022Az-01",
"properties": {
"hyperVGeneration": "V2",
"identifier": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-azure-edition-core"
},
"imagePath": null,
"osType": "Windows",
"provisioningState": "Succeeded",
"status": {
"downloadStatus": {
"downloadSizeInMB": 6710
},
"progressPercentage": 100,
"provisioningStatus": {
"operationId": "19742d69-4a00-4086-8f17-4dc1f7ee6681*E1E9889F0D1840B93150BD74D428EAE483CB67B0904F9A198C161AD471F670ED",
"status": "Succeeded"
}
},
"storagepathId": null,
"version": {
"name": "20348.2031.231006",
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMB": 130050
}
}
}
}
},
"resourceGroup": "myhci-rg",
"systemData": {
"createdAt": "2023-10-30T21:44:53.020512+00:00",
"createdBy": "guspinto@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-10-30T22:08:25.495995+00:00",
"lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
"lastModifiedByType": "Application"
},
"tags": {},
"type": "microsoft.azurestackhci/marketplacegalleryimages"
}
]
PS C:\Users\azcli>
如需此 CLI 命令的詳細資訊,請參閱 az stack-hci-vm image list。
檢視 VM 映像內容
您可能想要先檢視 VM 映像的屬性,再使用映像來建立 VM。 請遵循下列步驟來檢視影像屬性:
請遵循下列步驟,使用 Azure CLI 來檢視映像的屬性:
以系統管理員身分執行 PowerShell。
設定下列參數。
$subscription = "<Subscription ID>" $resource_group = "<Cluster resource group>" $mktplaceImage = "<Marketplace image name>"
您可以透過兩種不同的方式檢視影像屬性:指定識別碼或指定名稱和資源群組。 指定 Marketplace 映射識別符時,請執行下列步驟:
設定下列參數。
$mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"
執行下列命令以檢視屬性。
az stack-hci-vm image show --ids $mktplaceImageID
以下是此指令的範例輸出:
PS C:\Users\azcli> az stack-hci-vm image show --ids $mktplaceImageID Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus { "extendedLocation": { "name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl", "type": "CustomLocation" }, "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage", "location": "eastus", "name": "myhci-marketplaceimage", "properties": { "containerName": null, "hyperVGeneration": null, "identifier": null, "imagePath": null, "osType": "Windows", "provisioningState": "Succeeded", "status": null, "version": null }, "resourceGroup": "myhci-rg", "systemData": { "createdAt": "2022-08-05T20:52:38.579764+00:00", "createdBy": "guspinto@microsoft.com", "createdByType": "User", "lastModifiedAt": "2022-08-05T20:52:38.579764+00:00", "lastModifiedBy": "guspinto@microsoft.com", "lastModifiedByType": "User" }, "tags": null, "type": "microsoft.azurestackhci/galleryimages" } PS C:\Users\azcli>
刪除 VM 映像
如果下載因為某些原因而失敗,或不再需要映像,您可能會想要刪除 VM 映射。 請遵循下列步驟來刪除 VM 映像。
以系統管理員身分執行 PowerShell。
設定以下參數︰
$subscription = "<Subscription ID>" $resource_group = "<Cluster resource group>" $mktplaceImage = "<Markeplace image name>"
拿掉現有的 VM 映像。 執行以下命令:
az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes
您可以刪除映像兩種方式:
- 指定名稱和資源群組。
- 指定標識碼。
刪除映射之後,您可以檢查映像是否已移除。 以下是藉由指定名稱和資源群組來刪除映像時的範例輸出。
PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "myhci-rg"
PS C:\Users\azcli> $mktplaceImage = "myhci-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Are you sure you want to perform this operation? (y/n): y
PS C:\Users\azcli> az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group 'myhci-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>