Azure Marketplace イメージを使用して Azure ローカル VM イメージを作成する

[アーティクル]
11/23/2024

適用対象: Azure Local バージョン 23H2

この記事では、Azure Marketplace のソースイメージを使用して Azure Local 用の仮想マシン (VM) イメージを作成する方法について説明します。 Azure portal または Azure CLI を使用して VM イメージを作成し、これらの VM イメージを使用して Azure Local に Arc VM を作成できます。

重要

追加の検証が実行されると、最新の更新プログラムが VM イメージに反映されるまでに時間がかかる場合があります。

前提条件

開始する前に、次の前提条件が満たされていることを確認してください。

Azure CLI
Azure Portal

前提条件を確認してしてください。
クライアントを使用して Azure Local インスタンスに接続する場合は、「リモートでシステムに接続する」を参照してください。

Azure Marketplace から VM イメージを追加する

Azure Marketplace イメージから始まる VM イメージを作成し、このイメージを使用して Azure ローカルインスタンスに VM をデプロイします。

Azure CLI
Azure Portal

Azure CLI を使用して VM イメージを作成するには、次の手順に従います。

Azure Local でマシンに接続します。
サインイン。型:
```
az login --use-device-code
```

サブスクリプションを設定します。

az account set --subscription <Subscription ID>

パラメーターを設定します。

イメージのサブスクリプション、リソースグループ、場所、OS の種類のパラメーターを設定します。 < >のパラメーターを適切な値に置き換えます。

$subscription = "<Subscription ID>"
$resource_group = "<Resource group>"
$mktplaceImage = "<Marketplace image name>"
$customLocationName = "<Custom location name>"
$customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Local>" --query id -o tsv)
$location = "<Location for your Azure Local>"
$osType = "<OS of source image>"

パラメーターについては次の表で説明します。

パラメーター	説明
`subscription`	Azure Local に関連付けられているサブスクリプション。
`resource-group`	このイメージに関連付ける Azure Local のリソースグループ。
`name`	Azure Local の Marketplace イメージの名前。
`customLocation`	Azure Local のカスタムの場所のリソース ID。
`location`	Azure Local の場所。たとえば、`eastus` になります。
`os-type`	ソースイメージに関連付けられているオペレーティングシステム。 Windows または Linux を使用できます。

出力例を次に示します。

PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "mylocal-rg"
PS C:\Users\azcli> $mktplaceImage= "mylocal-marketplaceimage"
PS C:\Users\azcli> $customLocationName = "mylocal-cl"
PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName
PS C:\Users\azcli> $location = "eastus"
PS C:\Users\azcli> $ostype = "Windows"

Marketplace イメージから VM イメージを作成する

作成する目的の VM イメージを指定する追加のパラメーターを設定します。マーケットプレースイメージのオファー、発行元、SKU、バージョンを含める必要があります。 <>のパラメーターを適切な値に置き換えます。

$publisher = "<Publisher name>"
$offer = "<OS offer>"
$sku = "<Image SKU>"

次の表を使用して、使用可能な Marketplace イメージとその属性値を見つけます。

Name	発行元	プラン	SKU
Windows 11 Enterprise マルチセッション + Microsoft 365	microsoftwindowsdesktop	office-365	win11-21h2-avd-m365 win11-23h2-avd-m365
Windows 10 Enterprise マルチセッション + Microsoft 365	microsoftwindowsdesktop	office-365	win10-21h2-avd-m365 win10-22h2-avd-m365
Windows 11 Pro	microsoftwindowsdesktop	windows-11	win11-21h2-pro win11-22h2-pro win11-23h2-pro
Windows 11 Enterprise	microsoftwindowsdesktop	windows-11	win11-21h2-ent win11-22h2-ent win11-23h2-ent
Windows 11 Enterprise マルチセッション	microsoftwindowsdesktop	windows-11	win11-21h2-avd win11-22h2-avd win11-23h2-avd
Windows 10 Pro	microsoftwindowsdesktop	windows-10	win10-22h2-pro-g2
Windows 10 Enterprise	microsoftwindowsdesktop	windows-10	win10-22h2-ent-g2
Windows 10 Enterprise マルチセッション	microsoftwindowsdesktop	windows-10	win10-22h2-avd
Windows Server 2022 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2022-datacenter-azure-edition-hotpatch 2022-datacenter-azure-edition-core 2022-datacenter-azure-edition
Windows Server 2019	microsoftwindowsserver	windowsserver	2019-datacenter-gensecond 2019-datacenter-core-g2
Windows Server 2022 の SQL Server 2022 Enterprise	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

Windows Server 2019 Datacenter イメージを作成する場合は、次のパラメーターがあります。

$publisher = "microsoftwindowsserver" 
$offer = "windowsserver" 
$sku = "2019-datacenter-gensecond"

指定したマーケットプレースイメージで始まる VM イメージを作成します。

az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku

出力例を次に示します。

PS C:\Users\azcli> az stack-hci-vm image create --custom-location $cl --name $mktplaceImage --os-type $ostype --resource-group $rg --publisher $publisher --offer $offer --sku $sku 
{ 
  "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/marketplacegalleryimages/myhci-marketplaceimage", 
\ 
  "location": "eastus", 
  "name": "myhci-marketplaceimage", 
  "properties": { 
    "cloudInitDataSource": null, 
    "containerId": null, 
    "hyperVGeneration": null, 
    "identifier": { 
      "offer": "windowsserver", 
      "publisher": "microsoftwindowsserver", 
      "sku": "2019-datacenter-gensecond" 
    }, 
    "osType": "Windows", 
    "provisioningState": "Succeeded", 
    "status": { 
      "downloadStatus": { 
        "downloadSizeInMb": 10832 
      }, 
      "errorCode": "", 
      "errorMessage": "", 
      "progressPercentage": 100, 
      "provisioningStatus": { 
        "operationId": "13efc468-7473-429f-911b-858c1e6fc1d5*B11A62EE76B08EF194F8293CDD40F7BC71BFB93255D5A99DD11B4167690752D9", 
        "status": "Succeeded" 
      } 
    }, 
    "version": { 
      "name": "17763.6293.240905", 
      "properties": { 
        "storageProfile": { 
          "osDiskImage": { 
            "sizeInMb": 130050 
          } 
        } 
      } 

    } 
  }, 
  "resourceGroup": "mylocal-rg", 
  "systemData": { 
    "createdAt": "2024-09-23T18:53:13.734389+00:00", 
    "createdBy": "guspinto@contoso.com", 
    "createdByType": "User", 
    "lastModifiedAt": "2024-09-23T19:06:07.532276+00:00", 
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05", 
    "lastModifiedByType": "Application" 
  }, 

  "tags": null, 
  "type": "microsoft.azurestackhci/marketplacegalleryimages" 
}

この CLI コマンドの詳細については、 az stack-hci-vm イメージを参照してください。

VM イメージを一覧表示する

管理するイメージを選択するには、VM イメージの一覧を表示する必要があります。

Azure CLI
Azure Portal

Azure CLI を使用して VM イメージを一覧表示するには、次の手順に従います。

PowerShell を管理者として実行します。

パラメーターを設定する。

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

Azure Local に関連付けられているすべての VM イメージを一覧表示します。次のコマンドを実行します。
```
az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
```
使用するコマンドに応じて、Azure Local に関連付けられているイメージの対応するセットが一覧表示されます。
- サブスクリプションのみを指定した場合、コマンドはサブスクリプション内のすべてのイメージを一覧表示します。
- サブスクリプションとリソースグループの両方を指定すると、コマンドによってリソースグループ内のすべてのイメージが一覧表示されます。
これらのイメージには次のものが含まれます。
- Marketplace イメージからの VM イメージ。
- Azure Storage アカウント内に存在するカスタムイメージ、またはシステムまたはシステムに接続されているクライアント上のローカル共有内にあるカスタムイメージ。

出力例を次に示します。

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を参照してください。

VM イメージのプロパティを表示する

イメージを使用して VM を作成する前に、VM イメージのプロパティを表示したい場合があります。イメージのプロパティを表示するには、次の手順に従います。

Azure CLI
Azure Portal

Azure CLI を使用してイメージのプロパティを表示するには、次の手順に従います。

PowerShell を管理者として実行します。

次のパラメーターを設定します。

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

イメージのプロパティは、2 つの異なる方法で表示できます。ID を指定するか、名前とリソースグループを指定します。 Marketplace イメージ ID を指定するときは、次の手順を実行します。

次のパラメーターを設定します。

$mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-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/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>

VM イメージの更新

Azure Marketplace で新しい更新されたイメージを使用できる場合、Azure Local 上の VM イメージは古くなり、更新する必要があります。更新操作は、イメージのインプレース更新ではありません。代わりに、更新されたイメージが使用可能な VM イメージを確認し、更新するイメージを選択できます。更新後、VM イメージの作成操作では、新しく更新されたイメージが使用されます。

VM イメージを更新するには、Azure portal で次の手順を使用します。

更新プログラムが利用可能かどうかを確認するには、一覧ビューから VM イメージを選択します。

Overview ブレードには、新しい VM イメージがダウンロード可能な場合は、そのイメージが表示されるバナーが表示されます。新しいイメージに更新するには、矢印アイコン選択。
イメージの詳細を確認し、 Review と create を選択します。既定では、新しいイメージでは、前のイメージと同じリソースグループとインスタンスの詳細が使用されます。

新しいイメージの名前は、前のイメージの名前に基づいてインクリメントされます。たとえば、 winServer2022-01 という名前の既存のイメージには、 winServer2022-02 という名前の更新されたイメージがあります。
操作を完了するには、[作成] を選択します。

新しい VM イメージが作成されたら、新しいイメージを使用して VM を作成し、VM が正常に動作することを確認します。検証後、古い VM イメージを削除できます。

Note

このリリースでは、そのイメージに関連付けられている VM が実行されている場合、VM イメージを削除することはできません。 VM を停止し、VM イメージを削除します。

VM イメージの削除

何らかの理由でダウンロードが失敗した場合、またはイメージが不要になった場合は、VM イメージを削除できます。 VM イメージを削除するには、次の手順に従います。

Azure CLI
Azure Portal

PowerShell を管理者として実行します。

次のパラメーターを設定します。

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

既存の VM イメージを削除します。次のコマンドを実行します。

az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes

イメージは、次の 2 つの方法で削除できます。

名前とリソースグループを指定します。
ID を指定します。

イメージを削除したら、イメージが削除されていることを確認できます。名前とリソースグループを指定してイメージが削除されたときの出力例を次に示します。

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 Marketplace イメージを使用して Azure ローカル VM イメージを作成する

前提条件

Azure Marketplace から VM イメージを追加する

パラメーターを設定します。

Marketplace イメージから VM イメージを作成する

VM イメージを一覧表示する

VM イメージのプロパティを表示する

VM イメージの更新

VM イメージの削除

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Marketplace イメージを使用して Azure ローカル VM イメージを作成する

前提条件

Azure Marketplace から VM イメージを追加する

サインインしてサブスクリプションを設定する

パラメーターを設定します。

Marketplace イメージから VM イメージを作成する

VM イメージを一覧表示する

VM イメージのプロパティを表示する

VM イメージの更新

VM イメージの削除

次のステップ

フィードバック

その他のリソース