Set-AzVMDataDisk
语法
ChangeWithName
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ChangeWithLun
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Lun] <Int32>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Set-AzVMDataDisk cmdlet 修改虚拟机数据磁盘的属性。
示例
示例 1：修改数据磁盘的缓存模式
$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM
第一个命令使用 Get-AzVM 获取名为 ContosoVM07 的虚拟机。
该命令将其存储在$VM变量中。
第二个命令修改$VM虚拟机上名为 DataDisk01 的数据磁盘的缓存模式。
该命令将结果传递给实现更改的 Update-AzVM cmdlet。
对现金模式的更改会导致虚拟机重启。
示例 2
修改虚拟机数据磁盘的属性。 (autogenerated)
Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>
参数
-Caching
指定磁盘的缓存模式。
此参数的可接受值为：
- ReadOnly
- ReadWrite 默认值为 ReadWrite。
更改此值会导致虚拟机重启。
此设置会影响磁盘的一致性和性能。
参数属性
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiskEncryptionSetId
指定客户托管磁盘加密集的资源 ID。 这只能为托管磁盘指定。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiskSizeInGB
指定数据磁盘的大小（以 GB 为单位）。
参数属性
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Lun
指定此 cmdlet 修改的数据磁盘的逻辑单元号（LUN）。
参数属性
参数集
ChangeWithLun
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
指定此 cmdlet 修改的数据磁盘的名称。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ChangeWithName
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-StorageAccountType
虚拟机托管磁盘的帐户类型。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-VM
指定此 cmdlet 修改数据磁盘的虚拟机。
若要获取虚拟机对象，请使用 Get-AzVM cmdlet。
参数属性
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WriteAccelerator
指定是否应在数据磁盘上启用或禁用 WriteAccelerator。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输出
