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

Add-AzVMDataDisk

Модуль:
Az.Compute Module

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

Синтаксис

VmNormalDiskParameterSetName (по умолчанию) 

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>]

VmManagedDiskParameterSetName 

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. Изменение этого значения приводит к перезапуску виртуальной машины. Этот параметр влияет на согласованность и производительность диска.

Свойства параметра

Тип:CachingTypes
Default value:None
Допустимые значения:None, ReadOnly, ReadWrite
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-CreateOption

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

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:6
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DeleteOption

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DiskEncryptionSetId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DiskSizeInGB

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

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Lun

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

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:5
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ManagedDiskId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VmManagedDiskParameterSetName
Position:8
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SourceImageUri

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:SourceImage

Наборы параметров

VmNormalDiskParameterSetName
Position:7
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SourceResourceId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-StorageAccountType

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VmManagedDiskParameterSetName
Position:9
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-VhdUri

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VmNormalDiskParameterSetName
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-VM

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

Свойства параметра

Тип:PSVirtualMachine
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:VMProfile

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WriteAccelerator

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VmManagedDiskParameterSetName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSVirtualMachine

String

CachingTypes

Nullable<T>

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

PSVirtualMachine

PSVirtualMachineScaleSetVM