你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Add-AzureDataDisk
将数据磁盘添加到虚拟机。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。
语法
Add-AzureDataDisk
[-CreateNew]
[-DiskSizeInGB] <Int32>
[-DiskLabel] <String>
[-LUN] <Int32>
[-MediaLocation <String>]
[-HostCaching <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Add-AzureDataDisk
[-Import]
[-DiskName] <String>
[-LUN] <Int32>
[-HostCaching <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Add-AzureDataDisk
[-ImportFrom]
[-DiskLabel] <String>
[-LUN] <Int32>
-MediaLocation <String>
[-HostCaching <String>]
-VM <IPersistentVM>
[-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 |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskLabel
指定新数据磁盘的磁盘标签。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskName
指定磁盘存储库中的数据磁盘的名称。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskSizeInGB
为新数据磁盘指定逻辑磁盘大小（以 GB 为单位）。
| 类型: | Int32 |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostCaching
指定磁盘的主机级缓存设置。 有效值为：
- 无
- ReadOnly
- ReadWrite
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Import
指示此 cmdlet 从映像存储库导入现有数据磁盘。
| 类型: | SwitchParameter |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImportFrom
指示此 cmdlet 从存储帐户中的 Blob 导入现有数据磁盘。
| 类型: | SwitchParameter |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| Aliases: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LUN
指定虚拟机中数据驱动器的逻辑单元号（LUN）。 有效值为：0 到 15。 每个数据磁盘必须具有唯一的 LUN。
| 类型: | Int32 |
| Position: | 3 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MediaLocation
指定 Blob 在存储数据磁盘的 Azure 存储帐户中的位置。 如果未指定位置，该 cmdlet 会将数据磁盘存储在当前订阅的默认存储帐户中的 vhds 容器中。 如果 vhds 容器不存在，cmdlet 将创建 vhds 容器。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定此 cmdlet 将数据磁盘附加到的虚拟机对象。 若要获取虚拟机对象，请使用 Get-AzureVM cmdlet。
| 类型: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |