Поделиться через

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>]
   [-SourceResourceId <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>]
   [-SourceResourceId <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. Команда назначает имя и размер виртуальной машине. Следующие три команды назначают пути трех дисков данных переменным $DataDiskVhdUri 01, $DataDiskVhdUri 02 и $DataDiskVhdUri 03. Этот подход предназначен только для удобочитаемости следующих команд. Последние три команды добавляют диск данных к виртуальной машине, хранящейся в $VirtualMachine. Команда указывает имя и расположение диска, а также другие свойства диска. URI каждого диска хранится в $DataDiskVhdUri 01, $DataDiskVhdUri 02 и $DataDiskVhdUri 03.

Пример 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
  • Значение по умолчанию — ReadWrite. Изменение этого значения приводит к перезапуску виртуальной машины. Этот параметр влияет на согласованность и производительность диска.
Тип:CachingTypes
Допустимые значения:None, ReadOnly, ReadWrite
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CreateOption

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

  • Прикреплять. Укажите этот параметр для создания виртуальной машины на специализированном диске. При указании этого параметра не указывайте параметр SourceImageUri. VhdUri — это все, что необходимо для того, чтобы сообщить платформе Azure расположение виртуального жесткого диска (VHD) для подключения как диска данных к виртуальной машине.
  • Пустой. Укажите это, чтобы создать пустой диск данных.
  • FromImage. Укажите этот параметр, чтобы создать виртуальную машину на основе обобщенного образа или диска. При указании этого параметра необходимо также указать параметр SourceImageUri, чтобы сообщить платформе Azure расположение виртуального жесткого диска для подключения как диска данных. Параметр VhdUri используется в качестве расположения, определяющего место хранения виртуального жесткого диска данных при использовании виртуальной машины.
  • Пустой. Это значение используется при создании пустого диска данных.
  • Копировать. Это значение используется для создания диска данных из моментального снимка или другого диска. восстановление: это значение используется для создания диска данных из точки восстановления диска.
Тип:String
Position:6
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeleteOption

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskEncryptionSetId

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DiskSizeInGB

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

Тип:Nullable<T>[Int32]
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Lun

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

Тип:Nullable<T>[Int32]
Position:5
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ManagedDiskId

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

Тип:String
Position:8
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SourceImageUri

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

Тип:String
Aliases:SourceImage
Position:7
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SourceResourceId

Идентификатор ARM моментального снимка или точки восстановления диска, из которой создается диск.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StorageAccountType

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

Тип:String
Position:9
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VhdUri

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

Тип:String
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VM

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

Тип:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WriteAccelerator

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

PSVirtualMachine

String

CachingTypes

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

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

PSVirtualMachine

PSVirtualMachineScaleSetVM