通过

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

Add-AzureDataDisk

模块:
Azure Module

将数据磁盘添加到虚拟机。

注释

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

CreateNew （默认值） 

Add-AzureDataDisk
    [-DiskSizeInGB] <Int32>
    [-DiskLabel] <String>
    [-LUN] <Int32>
    -VM <IPersistentVM>
    [-CreateNew]
    [-MediaLocation <String>]
    [-HostCaching <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Import 

Add-AzureDataDisk
    [-DiskName] <String>
    [-LUN] <Int32>
    -VM <IPersistentVM>
    [-Import]
    [-HostCaching <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

ImportFrom 

Add-AzureDataDisk
    [-DiskLabel] <String>
    [-LUN] <Int32>
    -MediaLocation <String>
    -VM <IPersistentVM>
    [-ImportFrom]
    [-HostCaching <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

说明

Add-AzureDataDisk cmdlet 将新的或现有的数据磁盘添加到 Azure 虚拟机对象。 使用 CreateNew 参数创建具有指定大小和标签的新数据磁盘。 使用 Import 参数从映像存储库附加现有磁盘。 使用 ImportFrom 参数从存储帐户中的 Blob 附加现有磁盘。 可以指定附加数据磁盘的主机缓存模式。

示例

示例 1：从存储库导入数据磁盘

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

此命令使用 Get-AzureVM cmdlet 获取 ContosoService 云服务中名为 VirtualMachine07 的虚拟机的虚拟机对象。 该命令使用管道运算符将其传递给当前 cmdlet。 该命令将现有数据磁盘从存储库附加到虚拟机。 数据磁盘的 LUN 为 0。 该命令使用 Update-AzureVM cmdlet 更新虚拟机以反映所做的更改。

示例 2：添加新数据磁盘

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

此命令获取名为 VirtualMachine08 的虚拟机的虚拟机对象。 该命令将它传递给当前 cmdlet。 该命令附加名为 MyNewDisk.vhd 的新数据磁盘。 该 cmdlet 在当前订阅的默认存储帐户的 vhds 容器中创建磁盘。 该命令将更新虚拟机以反映更改。

示例 3：从指定位置添加数据磁盘

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

此命令获取名为 Database 的虚拟机的虚拟机对象。 该命令将它传递给当前 cmdlet。 该命令从指定位置附加名为 Disk14.vhd 的现有数据磁盘。 该命令将更新虚拟机以反映更改。

参数

-CreateNew

指示此 cmdlet 创建数据磁盘。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

CreateNew
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DiskLabel

指定新数据磁盘的磁盘标签。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateNew
Position:2
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
ImportFrom
Position:2
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DiskName

指定磁盘存储库中的数据磁盘的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Import
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-DiskSizeInGB

为新数据磁盘指定逻辑磁盘大小（以 GB 为单位）。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

CreateNew
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-HostCaching

指定磁盘的主机级缓存设置。 有效值为：

  • 没有
  • ReadOnly
  • ReadWrite

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Import

指示此 cmdlet 从映像存储库导入现有数据磁盘。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

Import
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ImportFrom

指示此 cmdlet 从存储帐户中的 Blob 导入现有数据磁盘。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

ImportFrom
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

  • 继续
  • 忽略
  • 查询
  • 静默继续
  • 停下
  • 暂停

参数属性

类型:ActionPreference
默认值:None
支持通配符:False
不显示:False
别名:infa

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InformationVariable

指定信息变量。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:四

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-LUN

指定虚拟机中数据驱动器的逻辑单元号（LUN）。 有效值为：0 到 15。 每个数据磁盘必须具有唯一的 LUN。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MediaLocation

指定 Blob 在存储数据磁盘的 Azure 存储帐户中的位置。 如果未指定位置，该 cmdlet 会将数据磁盘存储在当前订阅的默认存储帐户中的 vhds 容器中。 如果 vhds 容器不存在，cmdlet 将创建 vhds 容器。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateNew
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

参数属性

类型:AzureSMProfile
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-VM

指定此 cmdlet 将数据磁盘附加到的虚拟机对象。 若要获取虚拟机对象，请使用 Get-AzureVM cmdlet。

参数属性

类型:IPersistentVM
默认值:None
支持通配符:False
不显示:False
别名:InputObject

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。