從一般化映像版本建立 VM

發行項
10/15/2024

從儲存在 Azure Compute Gallery (先前稱為共用映像庫) 中的一般化映像版本建立 VM。如果您想要使用特殊化映像建立 VM，請參閱從特殊化映像建立 VM。

本文說明如何從一般化映像建立 VM：

在您自己的資源庫中
使用 RBAC 在組織中共用
使用 RBAC 跨租用戶共用
與社群資源庫中的每個人共用
直接與您的訂用帳戶或租用戶共用

您自己的資源庫

使用 az sig image-definition list 來列出資源庫中的映像定義，以查看定義的名稱和識別碼。

resourceGroup=myGalleryRG
gallery=myGallery
az sig image-definition list --resource-group $resourceGroup --gallery-name $gallery --query "[].[name, id]" --output tsv

使用 az vm create 建立 VM。若要使用最新版本的映像，請將 --image 設定為映像定義的識別碼。

此範例用於建立使用 SSH 保護的 Linux VM。若要 Windows 或使用密碼保護 Linux VM，請移除 --generate-ssh-keys 以提示輸入密碼。如果您想要直接提供密碼，請將 --generate-ssh-keys 取代為 --admin-password。視需要取代此範例中的資源名稱。

imgDef="/subscriptions/<subscription ID where the gallery is located>/resourceGroups/myGalleryRG/providers/Microsoft.Compute/galleries/myGallery/images/myImageDefinition"
vmResourceGroup=myResourceGroup
location=eastus
vmName=myVM
adminUsername=azureuser

az group create --name $vmResourceGroup --location $location

az vm create\
   --resource-group $vmResourceGroup \
   --name $vmName \
   --image $imgDef \
   --admin-username $adminUsername \
   --generate-ssh-keys

您也可以使用 --image 參數的映像版本識別碼來使用特定版本。例如，若要使用映像 1.0.0 版類型：--image "/subscriptions/<subscription ID where the gallery is located>/resourceGroups/myGalleryRG/providers/Microsoft.Compute/galleries/myGallery/images/myImageDefinition/versions/1.0.0"。

當您擁有一般化映像版本之後，您就可以建立一或多個新的 VM。使用 New-AzVM Cmdlet。

在此範例中，我們使用映像定義識別碼，以確保新的 VM 將會使用最新的映像版本。您也可以使用 Set-AzVMSourceImage -Id 的映像版本識別碼來使用特定版本。例如，若要使用映像 1.0.0 版類型：Set-AzVMSourceImage -Id "/subscriptions/<subscription ID where the gallery is located>/resourceGroups/myGalleryRG/providers/Microsoft.Compute/galleries/myGallery/images/myImageDefinition/versions/1.0.0"。

請注意，使用特定映像版本表示，如果無法使用特定映像版本，則自動化可能會失敗，因為已從區域中刪除或移除。除非需要特定映像版本，否則建議您使用映像定義識別碼來建立新的 VM。

視需要取代這些範例中的資源名稱。

簡化的參數集

您可以使用簡化的參數集，從映像快速建立 VM。簡化的參數集會使用 VM 名稱，為您自動建立一些必要的資源，例如 vNet 和公用 IP 位址。

# Create some variables for the new VM 
$resourceGroup = "myResourceGroup"
$location = "South Central US"
$vmName = "myVMfromImage"

# Get the image. Replace the name of your resource group, gallery, and image definition. This will create the VM from the latest image version available.

$imageDefinition = Get-AzGalleryImageDefinition `
   -GalleryName myGallery `
   -ResourceGroupName myResourceGroup `
   -Name myImageDefinition

# Create user object
$cred = Get-Credential `
   -Message "Enter a username and password for the virtual machine."

# Create a resource group
New-AzResourceGroup `
   -Name $resourceGroup `
   -Location $location

New-AzVM `
   -ResourceGroupName $resourceGroup `
   -Location $location `
   -Name $vmName `
   -Image $imageDefinition.Id
   -Credential $cred

完整參數集

您可以使用完整的參數集，使用特定資源建立 VM。

# Create some variables for the new VM 
$resourceGroup = "myResourceGroup"
$location = "South Central US"
$vmName = "myVMfromImage"

# Get the image. Replace the name of your resource group, gallery, and image definition. This will create the VM from the latest image version available.

$imageDefinition = Get-AzGalleryImageDefinition `
   -GalleryName myGallery `
   -ResourceGroupName myResourceGroup `
   -Name myImageDefinition

# Create user object
$cred = Get-Credential `
   -Message "Enter a username and password for the virtual machine."

# Create a resource group
New-AzResourceGroup `
   -Name $resourceGroup `
   -Location $location

# Network pieces
$subnetConfig = New-AzVirtualNetworkSubnetConfig `
   -Name mySubnet `
   -AddressPrefix 192.168.1.0/24
$vnet = New-AzVirtualNetwork `
   -ResourceGroupName $resourceGroup `
   -Location $location `
   -Name MYvNET `
   -AddressPrefix 192.168.0.0/16 `
   -Subnet $subnetConfig
$pip = New-AzPublicIpAddress `
   -ResourceGroupName $resourceGroup `
   -Location $location `
  -Name "mypublicdns$(Get-Random)" `
  -AllocationMethod Static `
  -IdleTimeoutInMinutes 4
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig `
   -Name myNetworkSecurityGroupRuleRDP  `
   -Protocol Tcp `
  -Direction Inbound `
   -Priority 1000 `
   -SourceAddressPrefix * `
   -SourcePortRange * `
   -DestinationAddressPrefix * `
   -DestinationPortRange 3389 `
   -Access Deny
$nsg = New-AzNetworkSecurityGroup `
   -ResourceGroupName $resourceGroup `
   -Location $location `
  -Name myNetworkSecurityGroup `
  -SecurityRules $nsgRuleRDP
$nic = New-AzNetworkInterface `
   -Name myNic `
   -ResourceGroupName $resourceGroup `
   -Location $location `
  -SubnetId $vnet.Subnets[0].Id `
  -PublicIpAddressId $pip.Id `
  -NetworkSecurityGroupId $nsg.Id

# Create a virtual machine configuration using $imageDefinition.Id to use the latest image version.
$vmConfig = New-AzVMConfig `
   -VMName $vmName `
   -VMSize Standard_D1_v2 | `
   Set-AzVMOperatingSystem -Windows -ComputerName $vmName -Credential $cred | `
   Set-AzVMSourceImage -Id $imageDefinition.Id | `
   Add-AzVMNetworkInterface -Id $nic.Id

# Create a virtual machine
New-AzVM `
   -ResourceGroupName $resourceGroup `
   -Location $location `
   -VM $vmConfig

建立虛擬網路。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vNetName}?api-version=2020-05-01

{
    "properties": {
        "addressSpace": {
            "addressPrefixes": [
                "10.0.0.0/16"
            ]
        }
    },
    "location": "eastus"
}

建立子網路。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vNetName}/subnets/{subnetName}?api-version=2020-05-01

{
    "properties": {
        "addressPrefix": "10.0.0.0/16"
    },
}

建立公用 IP 位址。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{pIPName}?api-version=2020-11-01

{
  "location": "eastus"
}

建立網路安全性群組。

# @name vmNSG
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{nsgName}?api-version=2020-11-01

{
  "properties": {
    "securityRules": [
      {
        "name": "AllowSSH",
        "properties": {
          "protocol": "Tcp",
          "sourceAddressPrefix": "*",
          "destinationAddressPrefix": "*",
          "access": "Deny",
          "destinationPortRange": "3389",
          "sourcePortRange": "*",
          "priority": 1000,
          "direction": "Inbound"
        }
      }
    ]
  },
  "location": "eastus"
}

建立 NIC

# @name vmNIC
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{nicName}?api-version=2020-05-01

{
    "properties": {
        "enableAcceleratedNetworking": true,
        "networkSecurityGroup": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{nsgName}"
        },
        "ipConfigurations": [
            {
                "name": "ipconfig1",
                "properties": {
                    "subnet": {
                        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vNetName}/subnets/{subNetName}",
                    },
                    "publicIPAddress": {
                        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{pipName}"
          }
                }
            }
        ]
    },
    "location": "eastus",
}

建立 Linux VM。 oSProfile 區段包含一些 OS 特定詳細資料。如需 Windows 語法，請參閱下一個程式碼範例。

# @name vm
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2020-06-01

{
    "location": "eastus",
    "properties": {
        "hardwareProfile": {
            "vmSize": "Standard_DS3_v2"
        },
        "storageProfile": {
            "imageReference": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}/versions/{versionNumber}"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "managedDisk": {
                    "storageAccountType": "StandardSSD_LRS"
                },
                "createOption": "FromImage"
            }
        },
        "osProfile": {
            "adminUsername": "{your-username}",
            "computerName": "myVM",
            "linuxConfiguration": {
                "ssh": {
                    "publicKeys": [
                        {
                            "path": "/home/{your-username}/.ssh/authorized_keys",
                            "keyData": "{sshKey}",
                        }
                    ]
                },
                "disablePasswordAuthentication": true
            }
        },
        "networkProfile": {
            "networkInterfaces": [
                {
                    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{nicName}",
                }
            ]
        }
    },
}

建立 Windows VM。

# @name vm
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2020-06-01

{
    "location": "eastus",
    "properties": {
        "hardwareProfile": {
            "vmSize": "Standard_DS3_v2"
        },
        "storageProfile": {
            "imageReference": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}/versions/{versionNumber}"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "managedDisk": {
                    "storageAccountType": "StandardSSD_LRS"
                },
                "createOption": "FromImage"
            }
        },
        "osProfile": {
            "adminUsername": "{your-username}",
            "computerName": "myVM",
            "adminPassword": "{your-password}"
        },
        "networkProfile": {
            "networkInterfaces": [
                {
                    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{nicName}",
                }
            ]
        }
    },

現在您可以建立一或多個新 VM。此範例在美國東部資料中心的 myResourceGroup 中建立名為 myVM 的 VM。

前往您的映像定義。您可以使用資源篩選來顯示所有可用的映像定義。
在映像定義的頁面上，從頁面頂端的功能表中選取 [建立 VM]。
在 [資源群組] 中，選取 [建立新項目] 並輸入 myResourceGroup 作為名稱。
在 [虛擬機器名稱] 中，輸入 myVM。
在 [區域] 中，選取 [美國東部]。
針對 [可用性選項]，保留預設值 [不需要基礎結構備援]。
如果您從映像定義的頁面開始，映像的值會自動填入 latest 映像版本。
針對大小，從可用的大小清單中選擇 VM 大小，然後選擇 [選取]。
在 [系統管理員帳戶] 下方，您需要提供使用者名稱 (例如 azureuser) 和密碼或 SSH 金鑰。密碼長度至少必須有 12 個字元，而且符合定義的複雜度需求。
如果您想要允許遠端存取 VM，請在 [公用輸入連接埠] 下，選擇 [允許選取的連接埠]，然後從下拉式清單中選取 SSH (22) 或 RDP (3389)。如果您不想允許遠端存取 VM，針對 [公用輸入埠] 選取 [無]。
完成後，請選取頁面底部的 [檢閱 + 建立] 按鈕。
在 VM 通過驗證之後，選取頁面底部的 [建立] 以開始部署。

RBAC – 在組織內共用

如果資源庫所在的訂用帳戶位於相同的租用戶，則可使用透過 RBAC 共用的映像，透過 CLI 和 PowerShell 建立 VM。

您需要將要使用之映像的 imageID，並且需要確保將其複寫到要建立 VM 的區域。

CLI
PowerShell

請確認映像的狀態為 Generalized。如果您想要使用狀態為 Specialized 的映像，請參閱從特製化映像版本建立 VM。

imgDef="/SharedGalleries/1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-MYDIRECTSHARED/Images/myDirectDefinition/Versions/latest"
vmResourceGroup=myResourceGroup
location=westus
vmName=myVM
adminUsername=azureuser

az group create --name $vmResourceGroup --location $location

az vm create\
   --resource-group $vmResourceGroup \
   --name $vmName \
   --image $imgDef \
   --admin-username $adminUsername \
   --generate-ssh-keys

建立 VM。以您自己的資訊取代範例中的資訊。建立 VM 前，請確保映像複寫到所要建立 VM 的區域。

$resourceGroup = "myResourceGroup"
$location = "South Central US"
$vmName = "myVMfromImage"

# Set a variable for the image version in Tenant 1 using the full image ID of the image version
$image = "/subscriptions/<Tenant 1 subscription>/resourceGroups/<Resource group>/providers/Microsoft.Compute/galleries/<Gallery>/images/<Image definition>/versions/<version>"

# Create user object
$cred = Get-Credential -Message "Enter a username and password for the virtual machine."

# Create a resource group
New-AzResourceGroup -Name $resourceGroup -Location $location

# Networking pieces
$subnetConfig = New-AzVirtualNetworkSubnetConfig -Name mySubnet -AddressPrefix 192.168.1.0/24
$vnet = New-AzVirtualNetwork -ResourceGroupName $resourceGroup -Location $location `
  -Name MYvNET -AddressPrefix 192.168.0.0/16 -Subnet $subnetConfig
$pip = New-AzPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
  -Name "mypublicdns$(Get-Random)" -AllocationMethod Static -IdleTimeoutInMinutes 4
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name myNetworkSecurityGroupRuleRDP  -Protocol Tcp `
  -Direction Inbound -Priority 1000 -SourceAddressPrefix * -SourcePortRange * -DestinationAddressPrefix * `
  -DestinationPortRange 3389 -Access Allow
$nsg = New-AzNetworkSecurityGroup -ResourceGroupName $resourceGroup -Location $location `
  -Name myNetworkSecurityGroup -SecurityRules $nsgRuleRDP
$nic = New-AzNetworkInterface -Name myNic -ResourceGroupName $resourceGroup -Location $location `
  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $pip.Id -NetworkSecurityGroupId $nsg.Id

# Create a virtual machine configuration using the $image variable to specify the image
$vmConfig = New-AzVMConfig -VMName $vmName -VMSize Standard_D1_v2 | `
Set-AzVMOperatingSystem -Windows -ComputerName $vmName -Credential $cred | `
Set-AzVMSourceImage -Id $image | `
Add-AzVMNetworkInterface -Id $nic.Id

# Create a virtual machine
New-AzVM -ResourceGroupName $resourceGroup -Location $location -VM $vmConfig

RBAC - 從另一個租用戶共用

如果所要使用的映像儲存在非相同租用戶 (目錄) 的資源庫，則您必須登入每個租用戶以驗證您具有存取權。

您也需要將要使用之映像的 imageID，並且需要確保將其複寫到要建立 VM 的區域。您也需要來源資源庫的 tenantID 和所要建立 VM 的 tenantID。

CLI
PowerShell

在此範例中，我們會示範如何從一般化映像建立 VM。如果您想要使用特製化映像，請參閱使用特製化映像版本建立 VM。

您必須登入儲存映像的租用戶，取得存取權丈，然後登入所要建立 VM 的租用戶。在此情況下，tenant1 是映射的儲存位置，而 tenant2 是您想要建立 VM 的位置。這是 Azure 驗證您具有映像存取權的方式。


tenant1='<ID for tenant 1>'
tenant2='<ID for tenant 2>'

az account clear
az login --tenant $tenant1
az account get-access-token 
az login --tenant $tenant2
az account get-access-token

建立 VM。以您自己的資訊取代範例中的資訊。建立 VM 前，請確保映像複寫到所要建立 VM 的區域。

imageid="<ID of the image that you want to use>"
resourcegroup="<name for the resource group>"
location="<location where the image is replicated>"
user='<username for the VM>'
name='<name for the VM>'

az group create --location $location --resource-group $resourcegroup
az vm create \
  --resource-group $resourcegroup \
  --name $name \
  --image $imageid \
  --admin-username $user \
  --generate-ssh-keys

在此範例中，我們會示範如何從一般化映像建立 VM。如果您想要使用特製化映像，請參閱使用特製化映像版本建立 VM。


$tenant1 = "<Tenant 1 ID>"
$tenant2 = "<Tenant 2 ID>"
Connect-AzAccount -Tenant "<Tenant 1 ID>" -UseDeviceAuthentication
Connect-AzAccount -Tenant "<Tenant 2 ID>" -UseDeviceAuthentication

建立 VM。以您自己的資訊取代範例中的資訊。建立 VM 前，請確保映像複寫到所要建立 VM 的區域。

$resourceGroup = "myResourceGroup"
$location = "South Central US"
$vmName = "myVMfromImage"

# Set a variable for the image version in Tenant 1 using the full image ID of the image version
$image = "/subscriptions/<Tenant 1 subscription>/resourceGroups/<Resource group>/providers/Microsoft.Compute/galleries/<Gallery>/images/<Image definition>/versions/<version>"

# Create user object
$cred = Get-Credential -Message "Enter a username and password for the virtual machine."

# Create a resource group
New-AzResourceGroup -Name $resourceGroup -Location $location

# Networking pieces
$subnetConfig = New-AzVirtualNetworkSubnetConfig -Name mySubnet -AddressPrefix 192.168.1.0/24
$vnet = New-AzVirtualNetwork -ResourceGroupName $resourceGroup -Location $location `
  -Name MYvNET -AddressPrefix 192.168.0.0/16 -Subnet $subnetConfig
$pip = New-AzPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
  -Name "mypublicdns$(Get-Random)" -AllocationMethod Static -IdleTimeoutInMinutes 4
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name myNetworkSecurityGroupRuleRDP  -Protocol Tcp `
  -Direction Inbound -Priority 1000 -SourceAddressPrefix * -SourcePortRange * -DestinationAddressPrefix * `
  -DestinationPortRange 3389 -Access Allow
$nsg = New-AzNetworkSecurityGroup -ResourceGroupName $resourceGroup -Location $location `
  -Name myNetworkSecurityGroup -SecurityRules $nsgRuleRDP
$nic = New-AzNetworkInterface -Name myNic -ResourceGroupName $resourceGroup -Location $location `
  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $pip.Id -NetworkSecurityGroupId $nsg.Id

# Create a virtual machine configuration using the $image variable to specify the image
$vmConfig = New-AzVMConfig -VMName $vmName -VMSize Standard_D1_v2 | `
Set-AzVMOperatingSystem -Windows -ComputerName $vmName -Credential $cred | `
Set-AzVMSourceImage -Id $image | `
Add-AzVMNetworkInterface -Id $nic.Id

# Create a virtual machine
New-AzVM -ResourceGroupName $resourceGroup -Location $location -VM $vmConfig

社群資源庫

重要

Microsoft 不支援社群資源庫中的映像。

報告社群映像的問題

使用社群提交的虛擬機器映像有數個風險。映像可能包含惡意程式碼、安全性弱點或違反某人智慧財產權。為了協助建立安全可靠的社群體驗，您可在發現這些問題時報告映像。

報告社群資源庫問題的最簡單方式是使用入口網站，這會預設填入報告的諮詢：

針對連結問題或映像定義中欄位的其他資訊，請選取 [報告社群映像]。
如果映像版本包含惡意程式碼或特定映像版本發生其他問題，請在映像版本表格的 [報告版本] 資料行下選取 [報告]。

您也可使用下列連結以報告問題，但不會預先填入表單：

惡意映像：請連絡不當使用報告。
智慧財產權違規：請連絡侵權報告。

若要使用共用至社群資源庫的映像建立 VM，請使用映像 --image 的唯一識別碼，其格式如下：

/CommunityGalleries/<community gallery name, like: ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f>/Images/<image name>/Versions/latest

請依照下列指示來取得使用 CLI 的社群映像清單：

Step 1:  Show all 'Community images' in a specific location
az sig list-community --location westus2

Step 2: Once you have the public gallery name from Step 1, Get the Image definition (Name) of the image by running the following command
az sig image-definition list-community --public-gallery-name <<public gallery name>> --location westus2

Step 3: Finally, run the following command to list different image versions available for the specific image
az sig image-version list-community --public-gallery-name <<galleryname>> --gallery-image-definition <<image name>> --location westus2

若要從入口網站取得社群資源庫的公用名稱。依序移至 [虛擬機器]>[建立]>[Azure 虛擬機器]>[映像]>[查看所有映像]>[社群映像]>[公開資源庫名稱]。

在此範例中，我們會從 Linux 映像建立 VM，並建立 SSH 金鑰以進行驗證。

imgDef="/CommunityGalleries/ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f>/Images/myLinuxImage/Versions/latest"
vmResourceGroup=myResourceGroup
location=eastus
vmName=myVM
adminUsername=azureuser

az group create --name $vmResourceGroup --location $location

az vm create\
   --resource-group $vmResourceGroup \
   --name $vmName \
   --image $imgDef \
   --admin-username $adminUsername \
   --generate-ssh-keys

使用社群映像時，系統會提示您接受法律條款。該訊息如下所示：

To create the VM from community gallery image, you must accept the license agreement and privacy statement: http://contoso.com. (If you want to accept the legal terms by default, please use the option '--accept-term' when creating VM/VMSS) (Y/n):

取得映像的識別碼。此值將會用於 VM 部署要求中。

GET 
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/Locations/{location}/CommunityGalleries/{CommunityGalleryPublicName}/Images/{galleryImageName}/Versions/{1.0.0}?api-version=2021-07-01

回應：

"location": "West US",
  "identifier": {
    "uniqueId": "/CommunityGalleries/{PublicGalleryName}/Images/{imageName}/Versions/{verionsName}"
  },
  "name": "1.0.0"

嫌再您可以部署 VM。此範例需要 API 版本 2021-07-01 或更新版本。

PUT 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/{VMName}?api-version=2021-03-01   
{ 
 	"location": "{location}", 
 	"properties": { 
 	 	"hardwareProfile": { 
 	 	 	"vmSize": "Standard_D1_v2" 
 	 	}, 
 	 	"storageProfile": { 
 	 	 	"imageReference": { 
 	 	 	 	"communityGalleryImageId":"/communityGalleries/{publicGalleryName}/images/{galleryImageName}/versions/1.0.0" 
 	 	 	}, 
 	 	 	"osDisk": { 
 	 	 	 	"caching": "ReadWrite", 
 	 	 	 	"managedDisk": { 
 	 	 	 	 	"storageAccountType": "Standard_LRS" 
 	 	 	 	}, 
 	 	 	 	"name": "myVMosdisk", 
 	 	 	 	"createOption": "FromImage" 
 	 	 	} 
   	}, 
 	 	"osProfile": { 
 	 	 	"adminUsername": "azureuser", 
 	 	 	"computerName": "myVM", 
 	 	 	"adminPassword": "{password}}" 
 	 	}, 
 	 	"networkProfile": { 
 	 	 	"networkInterfaces": [ 
 	 	 	 	{ 
 	 	 	 	 	"id": "/subscriptions/00000000-0000-0000-0000-
000000000000/resourceGroups/{rg}/providers/Microsoft.Network/networkInterfaces/{networkIntefaceName}", 
 	 	 	 	 	"properties": { 
 	 	 	 	 	 	"primary": true 
 	 	 	 	 	} 
 	 	 	 	} 
 	 	 	] 
 	 	} 
 	} 
}

直接共用資源庫

重要

Azure Compute Gallery - 直接共用資源庫目前為「預覽」，並遵守 Azure Compute Gallery 的預覽條款。

若要在預覽期間將映像發佈至直接共用資源庫，您必須在 https://aka.ms/directsharedgallery-preview 註冊。所有 Azure 使用者都可以從直接共用資源庫建立 VM。

在預覽期間，您必須建立新的資源庫，並將屬性 sharingProfile.permissions 設定為 Groups。使用 CLI 建立資源庫時，請使用 --permissions groups 參數。您無法使用現有的資源庫，目前無法更新此屬性。

若要使用共用至訂用帳戶或租用戶的映像來建立 VM，您需要下列格式的映像唯一識別碼：

/SharedGalleries/<uniqueID>/Images/<image name>/Versions/latest

若要尋找與您共用的資源庫的 uniqueID，請使用 az sig list-shared。在此範例中，我們在美國西部區域尋找資源庫。

region=westus
az sig list-shared --location $region --query "[].name" -o tsv

使用資源庫名稱來尋找可用的映像。在此範例中，我們列出「美國西部」中的所有映像，並依名稱列出建立 VM、OS 和 OS 狀態所需的唯一識別碼。

galleryName="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $galleryName \
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

請確認映像的狀態為 Generalized。如果您想要使用狀態為 Specialized 的映像，請參閱從特製化映像版本建立 VM。

使用來自輸出的 Id 並附加 /Versions/latest，以使用最新版本作為 --image 的值，以利建立 VM。在此範例中，我們會從直接和我們共用的 Linux 映像建立 VM，並建立 SSH 金鑰以進行驗證。

imgDef="/SharedGalleries/1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-MYDIRECTSHARED/Images/myDirectDefinition/Versions/latest"
vmResourceGroup=myResourceGroup
location=westus
vmName=myVM
adminUsername=azureuser

az group create --name $vmResourceGroup --location $location

az vm create\
   --resource-group $vmResourceGroup \
   --name $vmName \
   --image $imgDef \
   --admin-username $adminUsername \
   --generate-ssh-keys

取得映像的識別碼。此值將會用於 VM 部署要求中。

GET 
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/Locations/{location}/sharedGalleries/{galleryUniqueName}/Images/{galleryImageName}/Versions/{1.0.0}?api-version=2021-07-01

回應：

"location": "West US",
  "identifier": {
    "uniqueId": "/sharedGalleries/{PublicGalleryName}/Images/{imageName}/Versions/{verionsName}"
  },
  "name": "1.0.0"

嫌再您可以部署 VM。此範例需要 API 版本 2021-07-01 或更新版本。

PUT 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/{VMName}?api-version=2021-03-01   
{ 
 	"location": "{location}", 
 	"properties": { 
 	 	"hardwareProfile": { 
 	 	 	"vmSize": "Standard_D1_v2" 
 	 	}, 
 	 	"storageProfile": { 
 	 	 	"imageReference": { 
 	 	 	 	"sharedGalleryImageId":"/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions/1.0.0" 
 	 	 	}, 
 	 	 	"osDisk": { 
 	 	 	 	"caching": "ReadWrite", 
 	 	 	 	"managedDisk": { 
 	 	 	 	 	"storageAccountType": "Standard_LRS" 
 	 	 	 	}, 
 	 	 	 	"name": "myVMosdisk", 
 	 	 	 	"createOption": "FromImage" 
 	 	 	} 
   	}, 
 	 	"osProfile": { 
 	 	 	"adminUsername": "azureuser", 
 	 	 	"computerName": "myVM", 
 	 	 	"adminPassword": "{password}}" 
 	 	}, 
 	 	"networkProfile": { 
 	 	 	"networkInterfaces": [ 
 	 	 	 	{ 
 	 	 	 	 	"id": "/subscriptions/00000000-0000-0000-0000-
000000000000/resourceGroups/{rg}/providers/Microsoft.Network/networkInterfaces/{networkIntefaceName}", 
 	 	 	 	 	"properties": { 
 	 	 	 	 	 	"primary": true 
 	 	 	 	 	} 
 	 	 	 	} 
 	 	 	] 
 	 	} 
 	} 
}

注意

已知問題：在Azure 入口網站中，如果您選取區域，再選取映像，然後變更區域，則您會收到錯誤訊息：「您只能在此映像的複寫區域中建立 VM」，即使映像複寫到該區域也一樣。若要解決錯誤，請選取不同的區域，然後切換回您想要的區域。如果映像可用，系統應該會清除錯誤訊息。

您也可以使用 Azure CLI 來檢查與您共用的映像。例如，您可以使用 az sig list-shared --location westus 來查看在美國西部區域中與您共用的映像。

在搜尋中輸入虛擬機器。
在 [服務] 底下，選取 [虛擬機器]。
在 [虛擬機器] 頁面中，選取 [建立]，然後選取 [虛擬機器]。 [建立虛擬機器] 頁面隨即開啟。
在 [基本資料] 索引標籤中的 [專案詳細資料] 底下，確定已選取正確的訂用帳戶，然後選擇建立新的資源群組或從下拉式清單選取資源群組。
在 [執行個體詳細資料] 下，輸入名稱作為虛擬機器名稱。
針對 [安全性類型]，請確定已選取 [標準]。
針對您的映像，選取 [查看所有映像]。 [選取映像] 頁面隨即開啟。
在左側功能表中的 [其他項目] 底下，選取 [直接共用映像 (預覽)]。 [其他項目 | 直接共用映像 (預覽)] 頁面隨即開啟。
本節中的範圍預設會設定為「訂用帳戶」，如果您未看到映像，請按兩下方塊外，將範圍變更為「租用戶」，以查看共用至整個租用戶的映像清單。
從清單中選取映像。請確定 OS 狀態為一般化。如果您想要使用特製化映像，請參閱使用特製化映像版本建立 VM。視您選擇的映像而定，將建立 VM 的區域將會變更以符合映像。
完成其餘選項，然後選取頁面底部的 [檢閱 + 建立] 按鈕。
在 [建立虛擬機器] 頁面上，您可以看到即將建立的 VM 詳細資料。當您準備好時，選取 [建立]。

共用方式為

從一般化映像版本建立 VM

您自己的資源庫

RBAC – 在組織內共用

RBAC - 從另一個租用戶共用

社群資源庫

報告社群映像的問題

直接共用資源庫

下一步

意見反應

其他資源