你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzVMOSDisk

参考

模块:: Az.Compute

设置虚拟机的操作系统磁盘属性。

语法

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Set-AzVMOSDisk cmdlet 设置虚拟机上的操作系统磁盘属性。

示例

示例 1：从平台映像设置虚拟机上的属性

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential) 
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

第一个命令获取名为 ResourceGroup11 的资源组中名为 AvailabilitySet13 的可用性集，然后将该对象存储在$AvailabilitySet变量中。第二个命令创建虚拟机对象，然后将其存储在$VirtualMachine变量中。该命令将名称和大小分配给虚拟机。虚拟机属于存储在$AvailabilitySet的可用性集。最终命令在 $VirtualMachine 中设置虚拟机上的属性。

示例 2：从通用用户映像设置虚拟机上的属性

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -SourceImageUri "https://mystorageaccount.blob.core.windows.net/vhds/myOSImage.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption fromImage -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

第一个命令获取名为 ResourceGroup11 的资源组中名为 AvailabilitySet13 的可用性集，并将该对象存储在$AvailabilitySet变量中。第二个命令创建虚拟机对象并将其存储在$VirtualMachine变量中。该命令将名称和大小分配给虚拟机。虚拟机属于存储在$AvailabilitySet的可用性集。最终命令在 $VirtualMachine 中设置虚拟机上的属性。

示例 3：从专用用户映像设置虚拟机上的属性

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

示例 4：在虚拟机操作系统磁盘上设置磁盘加密设置

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite -Windows -CreateOption "Attach" -DiskEncryptionKeyUrl "https://mytestvault.vault.azure.net/secrets/Test1/514ceb769c984379a7e0230bddaaaaaa" -DiskEncryptionKeyVaultId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mytestvault"
New-AzVM -VM $VirtualMachine -ResourceGroupName " ResourceGroup11"

本示例设置虚拟机操作系统磁盘上的磁盘加密设置。

示例 5：使用 DiskWithVMGuestState 的 VM OS 磁盘加密和 ConfidentialVmEncryptedWithCustomerKey 的磁盘加密集加密创建 ConfidentialVM 虚拟机。

# Create Resource Group
$Location = 'northeurope';
New-AzResourceGroup -Name $ResourceGroupName -Location $Location;

$vmSize = "Standard_DC2as_v5";        
$identityType = "SystemAssigned";
$secureEncryptGuestState = "DiskWithVMGuestState";
$vmSecurityType = "ConfidentialVM";
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force; 
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);

# Create Key Vault
New-AzKeyVault -Name $keyVaultName -Location $Location -ResourceGroupName $ResourceGroupName -Sku Premium -EnablePurgeProtection -EnabledForDiskEncryption;

$cvmAgent = Get-AzADServicePrincipal -ApplicationId '00001111-aaaa-2222-bbbb-3333cccc4444';
Set-AzKeyVaultAccessPolicy -VaultName $keyVaultName -ResourceGroupName $ResourceGroupName -ObjectId $cvmAgent.id -PermissionsToKeys get,release;

# Add Key vault Key
$KeyName = "keyname";
$KeySize = 3072;

Add-AzKeyVaultKey -VaultName $kvname -Name $KeyName -Size $KeySize -KeyOps wrapKey,unwrapKey -KeyType RSA -Destination HSM -Exportable -UseDefaultCVMPolicy;
        
# Capture Key Vault and Key details
$encryptionKeyVaultId = (Get-AzKeyVault -VaultName $keyVaultName -ResourceGroupName $ResourceGroupName).ResourceId;
$encryptionKeyURL = (Get-AzKeyVaultKey -VaultName $keyVaultName -KeyName $keyName).Key.Kid;

# Create new DES Config and Disk Encryption Set
$diskEncryptionType = "ConfidentialVmEncryptedWithCustomerKey";
$desConfig = New-AzDiskEncryptionSetConfig -Location $loc -SourceVaultId $encryptionKeyVaultId -KeyUrl $encryptionKeyURL -IdentityType SystemAssigned -EncryptionType $diskEncryptionType;
New-AzDiskEncryptionSet -ResourceGroupName $ResourceGroupName -Name $desName -DiskEncryptionSet $desConfig;
        
$diskencset = Get-AzDiskEncryptionSet -ResourceGroupName $rgname -Name $desName;
        
# Assign DES Access Policy to key vault
$desIdentity = (Get-AzDiskEncryptionSet -Name $desName -ResourceGroupName $ResourceGroupName).Identity.PrincipalId;
        
Set-AzKeyVaultAccessPolicy -VaultName $keyVaultName -ResourceGroupName $ResourceGroupName -ObjectId $desIdentity -PermissionsToKeys wrapKey,unwrapKey,get -BypassObjectIdValidation;
        
$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $vmSize;
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $computerName -Credential $cred -ProvisionVMAgent -EnableAutoUpdate;
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'windowsserver' -Skus '2022-datacenter-smalldisk-g2' -Version "latest";
        
$subnet = New-AzVirtualNetworkSubnetConfig -Name ($subnetPrefix + $ResourceGroupName) -AddressPrefix "10.0.0.0/24";
$vnet = New-AzVirtualNetwork -Force -Name ($vnetPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName -Location $loc -AddressPrefix "10.0.0.0/16" -Subnet $subnet;
$vnet = Get-AzVirtualNetwork -Name ($vnetPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName;
$subnetId = $vnet.Subnets[0].Id;
$pubip = New-AzPublicIpAddress -Force -Name ($pubIpPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName -Location $loc -AllocationMethod Dynamic -DomainNameLabel $domainNameLabel2;
$pubip = Get-AzPublicIpAddress -Name ($pubIpPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName;
$pubipId = $pubip.Id;
$nic = New-AzNetworkInterface -Force -Name ($nicPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName -Location $loc -SubnetId $subnetId -PublicIpAddressId $pubip.Id;
$nic = Get-AzNetworkInterface -Name ($nicPrefix + $ResourceGroupName) -ResourceGroupName $ResourceGroupName;
$nicId = $nic.Id;

$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $nicId;

# Set VM SecurityType and connect to DES
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -StorageAccountType "StandardSSD_LRS" -CreateOption "FromImage" -SecurityEncryptionType $secureEncryptGuestState -SecureVMDiskEncryptionSet $diskencset.Id;
$VirtualMachine = Set-AzVmSecurityProfile -VM $VirtualMachine -SecurityType $vmSecurityType;
$VirtualMachine = Set-AzVmUefi -VM $VirtualMachine -EnableVtpm $true -EnableSecureBoot $true;

New-AzVM -ResourceGroupName $ResourceGroupName -Location $loc -Vm $VirtualMachine;
$vm = Get-AzVm -ResourceGroupName $ResourceGroupName -Name $vmname;

# Verify the SecurityEncryptionType value on the disk.
# $vm.StorageProfile.OsDisk.ManagedDisk.SecurityProfile.SecurityEncryptionType == 'DiskWithVMGuestState';

参数

-Caching

指定操作系统磁盘的缓存模式。有效值为：

ReadOnly
ReadWrite 默认值为 ReadWrite。更改缓存值会导致虚拟机重启。此设置会影响磁盘的性能。

类型:	Nullable<T>[CachingTypes]
接受的值:	None, ReadOnly, ReadWrite
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CreateOption

指定此 cmdlet 是从平台或用户映像在虚拟机中创建磁盘，还是附加现有磁盘。有效值为：

附加。指定此选项以从专用磁盘创建虚拟机。指定此选项时，请不要指定 SourceImageUri 参数。请改用 Set-AzVMSourceImage cmdlet。还必须使用 Windows 或 Linux 参数来告知 Azure 平台 VHD 上的操作系统类型。 VhdUri 参数足以告知 Azure 平台要附加的磁盘的位置。
FromImage。指定此选项可从平台映像或通用用户映像创建虚拟机。对于通用用户映像，还需要指定 SourceImageUri 参数和 Windows 或 Linux 参数，以告知 Azure 平台操作系统磁盘 VHD 的位置和类型，而不是使用 Set-AzVMSourceImage cmdlet。对于平台映像， VhdUri 参数已足够。
空白。

类型:	String
Position:	5
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeleteOption

指定 VM 删除后 OS 磁盘删除选项。选项为“分离”、“删除”

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DiffDiskPlacement

指定操作系统磁盘的临时磁盘放置。用户可以在请求中使用此属性来选择用于临时 OS 磁盘预配的位置，即缓存磁盘或资源磁盘空间。有关临时 OS 磁盘大小要求的详细信息，请参阅上的 https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Windows VM 和 Linux VM https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements的临时 OS 磁盘大小要求。仅当参数 DiffDiskSetting 设置为“Local”时，才能使用此参数。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DiffDiskSetting

指定操作系统磁盘的不同磁盘设置。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DiskEncryptionKeyUrl

指定磁盘加密密钥的位置。

类型:	String
Position:	7
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DiskEncryptionKeyVaultId

指定包含磁盘加密密钥的密钥库的资源 ID。

类型:	String
Position:	8
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DiskEncryptionSetId

指定客户托管磁盘加密集的资源 ID。这只能为托管磁盘指定。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DiskSizeInGB

指定操作系统磁盘的大小（以 GB 为单位）。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyEncryptionKeyUrl

指定密钥加密密钥的位置。

类型:	String
Position:	9
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyEncryptionKeyVaultId

指定包含密钥加密密钥的密钥库的资源 ID。

类型:	String
Position:	10
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Linux

指示用户映像上的操作系统为 Linux。为基于用户映像的虚拟机部署指定此参数。

类型:	SwitchParameter
Position:	6
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskId

指定托管磁盘的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定操作系统磁盘的名称。

类型:	String
别名:	OSDiskName, DiskName
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecureVMDiskEncryptionSet

磁盘加密集的 ARM 资源 ID。允许客户为使用 ConfidentialVmEncryptedWithCustomerKey 加密类型创建的磁盘加密集提供 ARM ID。这将使客户能够将客户管理的密钥（CMK）加密与机密 VM 配合使用。参数 SecurityEncryptionType 值应为 DiskwithVMGuestState。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-SecurityEncryptionType

在 VM 的托管磁盘上设置 SecurityEncryptionType 值。可能的值包括：TrustedLaunch、ConfidentialVM_DiskEncryptedWithCustomerKey、ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey、ConfidentialVM_DiskEncryptedWithPlatformKey

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-SourceImageUri

为用户映像方案指定 VHD 的 URI。

类型:	String
别名:	SourceImage
Position:	4
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccountType

指定托管磁盘的存储帐户类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VhdUri

指定虚拟硬盘（VHD）的统一资源标识符（URI）。对于基于映像的虚拟机，此参数指定要在指定平台映像或用户映像时创建的 VHD 文件。这是从中复制映像二进制大型对象（BLOB）以启动虚拟机的位置。对于基于磁盘的虚拟机启动方案，此参数指定虚拟机直接用于启动的 VHD 文件。

类型:	String
别名:	OSDiskVhdUri, DiskVhdUri
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VM

指定要在其中设置操作系统磁盘属性的本地虚拟机对象。若要获取虚拟机对象，请使用 Get-AzVM cmdlet。

类型:	PSVirtualMachine
别名:	VMProfile
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Windows

指示用户映像上的操作系统是 Windows。

类型:	SwitchParameter
Position:	6
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WriteAccelerator

指定是否应在 OS 磁盘上启用或禁用 WriteAccelerator。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

PSVirtualMachine

String

输出

PSVirtualMachine

通过

Set-AzVMOSDisk

语法

说明

示例

示例 1：从平台映像设置虚拟机上的属性

示例 2：从通用用户映像设置虚拟机上的属性

示例 3：从专用用户映像设置虚拟机上的属性

示例 4：在虚拟机操作系统磁盘上设置磁盘加密设置

示例 5：使用 DiskWithVMGuestState 的 VM OS 磁盘加密和 ConfidentialVmEncryptedWithCustomerKey 的磁盘加密集加密创建 ConfidentialVM 虚拟机。

参数

-Caching

-CreateOption

-DefaultProfile

-DeleteOption

-DiffDiskPlacement

-DiffDiskSetting

-DiskEncryptionKeyUrl

-DiskEncryptionKeyVaultId

-DiskEncryptionSetId

-DiskSizeInGB

-KeyEncryptionKeyUrl

-KeyEncryptionKeyVaultId

-Linux

-ManagedDiskId

-Name

-SecureVMDiskEncryptionSet

-SecurityEncryptionType

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-Windows

-WriteAccelerator

输入

输出

其他资源

通过

Set-AzVMOSDisk

语法

说明

示例

示例 1：从平台映像设置虚拟机上的属性

示例 2：从通用用户映像设置虚拟机上的属性

示例 3：从专用用户映像设置虚拟机上的属性

示例 4：在虚拟机操作系统磁盘上设置磁盘加密设置

示例 5：使用 DiskWithVMGuestState 的 VM OS 磁盘加密和 ConfidentialVmEncryptedWithCustomerKey 的磁盘加密集加密创建 ConfidentialVM 虚拟机。

参数

-Caching

-CreateOption

-DefaultProfile

-DeleteOption

-DiffDiskPlacement

-DiffDiskSetting

-DiskEncryptionKeyUrl

-DiskEncryptionKeyVaultId

-DiskEncryptionSetId

-DiskSizeInGB

-KeyEncryptionKeyUrl

-KeyEncryptionKeyVaultId

-Linux

-ManagedDiskId

-Name

-SecureVMDiskEncryptionSet

-SecurityEncryptionType

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-Windows

-WriteAccelerator

输入

输出

相关链接

其他资源