Add-AzVMDataDisk

Ссылка

Модуль:: Az.Compute

Добавляет диск данных в виртуальную машину.

Синтаксис

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Add-AzVMDataDisk добавляет диск данных на виртуальную машину. Диск данных можно добавить к новой виртуальной машине при ее создании или к имеющейся виртуальной машине.

Примеры

Пример 1. Добавление дисков данных в новую виртуальную машину

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

Первая команда создает объект виртуальной машины и сохраняет его в переменной $VirtualMachine. Команда присваивает имя и размер виртуальной машине. Следующие три команды присваивают пути трех дисков данных переменным $DataDiskVhdUri01, $DataDiskVhdUri02 и $DataDiskVhdUri03. Этот подход предназначен только для удобочитаемости следующих команд. Последние три команды добавляют диск данных к виртуальной машине, хранящейся в $VirtualMachine. Команда указывает имя и расположение диска, а также другие свойства диска. Универсальный код ресурса (URI) каждого диска хранится в переменных $DataDiskVhdUri01, $DataDiskVhdUri02 и $DataDiskVhdUri03.

Пример 2. Добавление диска данных в существующую виртуальную машину

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Первая команда получает виртуальную машину с именем VirtualMachine07 с помощью командлета Get-AzVM . Она сохраняет имя виртуальной машины в переменной $VirtualMachine . Вторая команда добавляет диск данных на виртуальную машину, хранящуюся в $VirtualMachine. Последняя команда обновляет состояние виртуальной машины, хранящейся в $VirtualMachine в ResourceGroup11.

Пример 3. Добавление диска данных на новую виртуальную машину из обобщенного пользовательского образа

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

Первая команда создает объект виртуальной машины и сохраняет его в переменной $VirtualMachine. Команда присваивает имя и размер виртуальной машине. Следующие две команды назначают пути для образа данных и дисков данных $DataImageUri и переменных $DataDiskUri соответственно. Этот подход используется для улучшения удобочитаемости следующих команд. Окончательные команды добавляют диск данных на виртуальную машину, хранящуюся в $VirtualMachine. Команда указывает имя и расположение диска и другие свойства диска.

Пример 4. Добавление дисков данных на новую виртуальную машину из специализированного образа пользователя

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

Первая команда создает объект виртуальной машины и сохраняет его в переменной $VirtualMachine. Команда присваивает имя и размер виртуальной машине. Следующие команды назначают пути диска данных переменной $DataDiskUri. Этот подход используется для улучшения удобочитаемости следующих команд. Последняя команда добавляет диск данных на виртуальную машину, хранящуюся в $VirtualMachine. Команда указывает имя и расположение диска, а также другие свойства диска.

Параметры

-Caching

Задает режим кэширования диска. Допустимые значения для этого параметра:

ReadOnly
Чтение и запись
Значение по умолчанию — ReadWrite. Изменение этого значения приводит к перезапуску виртуальной машины. Этот параметр влияет на согласованность и производительность диска.

Type:	CachingTypes
Accepted values:	None, ReadOnly, ReadWrite
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CreateOption

Указывает, создает ли этот командлет диск на виртуальной машине из платформы или пользовательского образа, создает пустой диск или подключает существующий диск. Допустимые значения для этого параметра:

Прикрепить. Укажите этот параметр для создания виртуальной машины на специализированном диске. При указании этого параметра не указывайте параметр SourceImageUri . VhdUri — это все, что необходимо для того, чтобы сообщить платформе Azure расположение виртуального жесткого диска (VHD) для подключения в качестве диска данных к виртуальной машине.
Пусто Укажите это, чтобы создать пустой диск данных.
FromImage. Укажите этот параметр, чтобы создать виртуальную машину на основе обобщенного образа или диска. При указании этого параметра необходимо также указать параметр SourceImageUri, чтобы сообщить платформе Azure расположение виртуального жесткого диска в качестве диска данных. Параметр VhdUri используется в качестве расположения, определяющего место хранения виртуального жесткого диска данных при использовании виртуальной машины.

Type:	String
Position:	6
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeleteOption

Параметр удаления диска данных. Указывает, какое действие необходимо выполнить на диске после удаления виртуальной машины. Параметры: отсоединение, удаление.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskEncryptionSetId

Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков. Это можно указать только для управляемого диска.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskSizeInGB

Задает размер в гигабайтах пустого диска для подключения к виртуальной машине.

Type:	Nullable<T>[Int32]
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Lun

Указывает логический номер единицы (LUN) для диска данных.

Type:	Nullable<T>[Int32]
Position:	5
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagedDiskId

Указывает идентификатор управляемого диска.

Type:	String
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Указывает имя добавляемого диска данных.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SourceImageUri

Указывает исходный универсальный код ресурса (URI) диска, присоединенного этим командлетом.

Type:	String
Aliases:	SourceImage
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountType

Указывает тип учетной записи хранения управляемого диска.

Type:	String
Position:	9
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VhdUri

Указывает универсальный идентификатор ресурса (URI) для файла виртуального жесткого диска (VHD), который будет создан при использовании образа платформы или пользовательского образа. Этот командлет копирует двоичный большой объект образа (BLOB-объект) в это расположение. Это расположение, с которого нужно запустить виртуальную машину.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Указывает объект локальной виртуальной машины, в который необходимо добавить диск данных. Для получения объекта виртуальной машины можно использовать командлет Get-AzVM . Для создания объекта виртуальной машины можно использовать командлет New-AzVMConfig .

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WriteAccelerator

Указывает, следует ли включить или отключить WriteAccelerator на управляемом диске данных.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Выходные данные

PSVirtualMachine

PSVirtualMachineScaleSetVM

Add-AzVMDataDisk

Синтаксис

Описание

Примеры

Пример 1. Добавление дисков данных в новую виртуальную машину

Пример 2. Добавление диска данных в существующую виртуальную машину

Пример 3. Добавление диска данных на новую виртуальную машину из обобщенного пользовательского образа

Пример 4. Добавление дисков данных на новую виртуальную машину из специализированного образа пользователя

Параметры

-Caching

-CreateOption

-DefaultProfile

-DeleteOption

-DiskEncryptionSetId

-DiskSizeInGB

-Lun

-ManagedDiskId

-Name

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-WriteAccelerator

Входные данные

Выходные данные

Обратная связь

Дополнительные ресурсы

Add-AzVMDataDisk

Синтаксис

Описание

Примеры

Пример 1. Добавление дисков данных в новую виртуальную машину

Пример 2. Добавление диска данных в существующую виртуальную машину

Пример 3. Добавление диска данных на новую виртуальную машину из обобщенного пользовательского образа

Пример 4. Добавление дисков данных на новую виртуальную машину из специализированного образа пользователя

Параметры

-Caching

-CreateOption

-DefaultProfile

-DeleteOption

-DiskEncryptionSetId

-DiskSizeInGB

-Lun

-ManagedDiskId

-Name

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-WriteAccelerator

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Дополнительные ресурсы