使用本機共用中的映像建立 Azure 本機 VM 映像

• 請務必檢閱並 完成必要條件。

• 針對 Azure 本機本機共用中的自訂映像，您將具備下列額外的必要條件：

  • 您應該已將 VHD/VHDX 上傳至系統上的本機共用。
  • VHDX 映像必須是第 2 代類型且已啟用安全開機。
  • VHDX 映像必須使用 來準備 sysprep /generalize /shutdown /oobe。 如需詳細資訊，請參閱 Sysprep 命令行選項。
  • 映像應該位於實例中所有機器可用的叢集共用磁碟區上。 支援 Windows 和 Linux 作業系統。

• 如果使用用戶端連線到您的 Azure 本機實例，請參閱 透過 Azure CLI 用戶端連線到 Azure 本機。

• 請務必檢閱並 完成必要條件。

• 針對 Azure 本機本機共用中的自訂映像，您將具備下列額外的必要條件：

  • 您應該已將 VHD/VHDX 上傳至系統上的本機共用。
  • VHDX 映像必須是第 2 代類型且已啟用安全開機。
  • VHDX 映像必須使用 來準備 sysprep /generalize /shutdown /oobe。 如需詳細資訊，請參閱 Sysprep 命令行選項。
  • 映像應該位於實例中所有機器可用的叢集共用磁碟區上。 支援 Windows 和 Linux 作業系統。

請遵循下列步驟，使用 Azure CLI 建立 VM 映射。

登入並設定訂用帳戶

1. 線上到 Azure 本機上的電腦 。

2. 登入。 輸入：

   az login --use-device-code
   

3. 設定您的訂用帳戶。

   az account set --subscription <Subscription ID>
   

設定一些參數

1. 設定映像的訂用帳戶、資源群組、位置、OS 類型。 將中的 < > 參數取代為適當的值。

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $location = "<Location for your Azure Local>"
   $imageName = <VM image name>
   $imageSourcePath = <path to the source image>
   $osType = "<OS of source image>"
   

   下表會說明這些參數：

   參數	描述
   subscription	您與此映像相關聯的 Azure 本機訂用帳戶群組。
   resource_group	您與此映像相關聯的 Azure 本機資源群組。
   location	Azure 本機的位置。 例如，可以是 eastus。
   image-path	從本機共用中的映像開始建立的 VM 映像名稱。 注意：Azure 會拒絕包含關鍵詞 Windows 的所有名稱。
   name	系統上來源資源庫映像的路徑（僅限 VHDX）。 例如， C：\OSImages\winos.vhdx。 請參閱來源映像的必要條件。
   os-type	與來源映像相關聯的操作系統。 這可以是 Windows 或 Linux。

   以下是範例輸出：

   PS C:\Users\azcli> $subscription = "<Subscription ID>"
   PS C:\Users\azcli> $resource_group = "mylocalrg"
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $osType = "Windows"
   PS C:\ClusterStorage\Volume1> $imageName = "mylocal-localimage"
   PS C:\ClusterStorage\Volume1> $imageSourcePath = "C:\ClusterStorage\Volume1\Windows_K8s_17763.2928.220505-1621_202205101158.vhdx"
   

從本機共用中的映像建立 VM 映像

1. 選取自定義位置以部署 VM 映像。 自定義位置應對應至 Azure 本機的自定義位置。 取得 Azure 本機的自定義位置標識碼。 執行以下命令：

   $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for system>" --query id -o tsv)
   

2. 在 Azure 本機的本機共用中建立 VM 映射，從指定的映像開始。

   az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
   
   

   VM 映射開始部署作業。

   在此範例中，已使用 --storage-path-id 旗標指定記憶體路徑，並確保工作負載數據（包括 VM、VM 映射、非 OS 數據磁碟）都放在指定的記憶體路徑中。

   如果未指定 旗標，工作負載數據會自動放在高可用性記憶體路徑中。

映像部署需要數分鐘的時間才能完成。 下載映像所花費的時間取決於本機共用中的映像大小，以及可供下載的網路頻寬。

以下是範例輸出：

PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resource_group --name "myhci-cl" --query id -o tsv)
PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
type="CustomLocation" --location $Location --name $mktplaceImage --os-type $osType --image-path $mktImageSourcePath
Command group 'azurestackhci' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
{
  "extendedLocation": {
    "name": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-localimage",
  "location": "eastus",
  "name": "mylocal-localimage",
  "properties": {
    "identifier": null,
    "imagePath": null,
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": {
      "downloadStatus": {},
      "progressPercentage": 100,
      "provisioningStatus": {
        "operationId": "82f58893-b252-43db-97a9-258f6f7831d9*43114797B86E6D2B28C4B52B02302C81C889DABDD9D890F993665E223A5947C3",
        "status": "Succeeded"
      }
    },
    "storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
    "version": {
      "name": null,
      "properties": {
        "storageProfile": {
          "osDiskImage": {}
        }
      }
    }
  },
  "resourceGroup": "myhci-rg",
  "systemData": {
    "createdAt": "2023-11-02T06:15:10.450908+00:00",
    "createdBy": "guspinto@contoso.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-02T06:15:56.689323+00:00",
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
    "lastModifiedByType": "Application"
  },
  "tags": null,
  "type": "microsoft.azurestackhci/galleryimages"
}

PS C:\Users\azcli>

您可以下載位於 Azure 本機上本機共用的映像，然後使用該 VM 映像來部署虛擬機，以建立 VM 映像。

在 Azure 本機資源的 Azure 入口網站 中，執行下列步驟：

1. 移至 [ 資源>VM 映射]。

2. 選取 [+ 新增 VM 映射 ]，然後從下拉式清單中選取 [ 從本機共用新增 VM 映射]。

   

3. 在 [ 建立影像 ] 頁面上的 [ 基本] 索引 標籤上，輸入下列資訊：

   1. 訂用帳戶。 選取要與您的 VM 映像建立關聯的訂用帳戶。

   2. 資源群組。 建立新的或選取您與 VM 映像相關聯的現有資源群組。

   3. 將映像儲存為 。 輸入 VM 映像的名稱。

   4. 自訂位置。 選取自定義位置以部署 VM 映像。 自定義位置應對應至 Azure 本機的自定義位置。

   5. OS 類型。 選取映像的 OS 作為 Windows 或 Linux。 這是與記憶體帳戶中映像相關聯的OS。

   6. VM 產生。 選取映像的產生。

   7. 來源。 映射的來源應該是 本機檔案共用 ，而且會自動填入。

   8. 本機檔案共享路徑。 指定系統上來源映像的本機共享路徑。

   9. 記憶體路徑。 選取 VM 映像的記憶體路徑。 選取 [ 自動選擇] 以自動 選取高可用性的記憶體路徑。 選取 [ 手動 選擇] 以指定記憶體路徑，以在 Azure 本機實例上儲存 VM 映射和組態檔。 在此情況下，請確定指定的儲存路徑有足夠的儲存空間。

4. 選取 [ 檢閱 + 建立 ] 以建立您的 VM 映像。

   

5. 輸入參數會經過驗證。 如果驗證成功，您可以檢閱 VM 映像詳細數據，然後選取 [ 建立]。

   

   針對 VM 映像開始 Azure Resource Manager 範本部署作業。 映像部署需要數分鐘的時間才能完成。 下載映像所需的時間取決於自定義映像的大小和可供下載的網路頻寬。

   您可以在 VM 映像方格上追蹤映像部署。 您可以看到已下載的 VM 映射清單，以及系統上正在下載的映射清單。

6. 映射下載完成時，VM 映射會顯示在映像清單中，而 [狀態 ] 會顯示為 [可用]。 若要檢視任何映像的詳細數據，請從 VM 映射清單中選取 VM 映像名稱。

請遵循下列步驟，使用 Azure CLI 列出 VM 映射。

1. 以系統管理員身分執行 PowerShell。

2. 設定部分參數。

   $subscription = "<Subscription ID associated with your Azure Local>"
   $resource_group = "<Resource group name for your Azure Local>"
   

3. 列出與您的 Azure 本機相關聯的所有 VM 映像。 執行以下命令：

   az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
   

   視所使用的命令而定，會列出一組與您 Azure 本機相關聯的對應映像。

   • 如果您只指定訂用帳戶，命令會列出訂用帳戶中的所有映像。
   • 如果您同時指定訂用帳戶和資源群組，命令會列出資源群組中的所有映像。

   這些映像包括：

   • 來自市集映像的 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": "mylocal-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。

在 Azure 本機資源的 Azure 入口網站 中，您可以在 VM 映射方格上追蹤 VM 映射部署。 您可以看到已下載的 VM 映射清單，以及系統上正在下載的映射清單。

請遵循下列步驟來檢視 Azure 入口網站 中的 VM 映射清單。

1. 在 Azure 入口網站 中，移至您的 Azure 本機資源。

2. 移至 [ 資源 > VM 映射]。

3. 在右窗格中，您可以檢視 VM 映像清單。

   

請遵循下列步驟，使用 Azure CLI 來檢視映像的屬性：

1. 以系統管理員身分執行 PowerShell。

2. 設定下列參數。

   $subscription = "<Subscription ID>"
   $resource_group = "<Azure Local resource group>"
   $mktplaceImage = "<Marketplace image name>"
   

3. 您可以透過兩種不同的方式檢視影像屬性：指定識別碼或指定名稱和資源群組。 指定 Marketplace 映射識別符時，請執行下列步驟：

   1. 設定下列參數。

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
      

   2. 執行下列命令以檢視屬性。

      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/mylocal-cl",
          "type": "CustomLocation"
        },
        "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage",
        "location": "eastus",
        "name": "mylocal-marketplaceimage",
        "properties": {
          "containerName": null,
          "hyperVGeneration": null,
          "identifier": null,
          "imagePath": null,
          "osType": "Windows",
          "provisioningState": "Succeeded",
          "status": null,
          "version": null
        },
        "resourceGroup": "mylocal-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> 
      

在 Azure 本機資源的 Azure 入口網站 中，執行下列步驟：

1. 移至 [ 資源>VM 映射]。 在右窗格中，會顯示 VM 映射清單。

   

2. 選取 VM 映像名稱 以檢視屬性。

   

1. 以系統管理員身分執行 PowerShell。

2. 設定以下參數︰

   $subscription = "<Subscription ID>"
   $resource_group = "<Azure Local resource group>"
   $mktplaceImage = "<Markeplace image name>"    
   

3. 拿掉現有的 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 = "mylocal-rg"
PS C:\Users\azcli> $mktplaceImage = "mymylocal-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 'mylocal-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>

在 Azure 本機資源的 Azure 入口網站 中，執行下列步驟：

1. 移至 [ 資源>VM 映射]。

2. 從右窗格中顯示的 VM 映射清單中，選取您要刪除的 VM 映射旁的垃圾桶圖示。

   

3. 當系統提示您確認刪除時，請選取 [ 是]。

   

刪除 VM 映射之後，VM 映射清單會重新整理以反映已刪除的映像。