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

New-AzureRmVMDataDisk

为虚拟机或 Vmss VM 创建本地数据磁盘对象。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

New-AzureRmVMDataDisk
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-Name <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-VhdUri <String>]
   [-SourceImageUri <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMDataDisk
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-Name <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzureRmVMDataDisk cmdlet 为虚拟机或 Vmss VM 创建本地数据磁盘对象。

示例

示例 1:将托管数据磁盘添加到 Vmss VM。

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $datadisk = New-AzureRmVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> Update-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk

第一个命令获取现有的托管磁盘。 下一个命令使用托管磁盘创建数据磁盘对象。 下一个命令获取资源组名称、vmss 名称和实例 ID 提供的现有 Vmss VM。 最后一个命令通过添加新的数据磁盘来更新 Vmss VM。

参数

-Caching

虚拟机数据磁盘的缓存。

类型:CachingTypes
接受的值:None, ReadOnly, ReadWrite
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-CreateOption

虚拟机数据磁盘的创建选项。

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

-DefaultProfile

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

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

-DiskSizeInGB

虚拟机数据磁盘的大小(以 GB 为单位)。

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

-Lun

虚拟机数据磁盘的 Lun。

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

-ManagedDiskId

虚拟机托管磁盘的 ID。

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

-Name

虚拟机数据磁盘的名称。

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

-SourceImageUri

虚拟机 OS 磁盘的源映像 URI。

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

-StorageAccountType

虚拟机托管磁盘的帐户类型。

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

-VhdUri

虚拟机数据磁盘的 Vhd URI。

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

-WriteAccelerator

指定是否应在托管数据磁盘上启用或禁用 WriteAccelerator。

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

输入

Int32

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

输出

PSVirtualMachineDataDisk