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

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>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-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>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-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. Команда указывает имя и расположение диска, а также другие свойства диска.

Пример 5. Добавление диска данных UltraSSD с пользовательской операцией ввода-вывода в секунду и пропускной способностью

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_D2s_v3"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "UltraData1" -Lun 0 -CreateOption 'Empty' -DiskSizeInGB 10 -Caching 'None' -StorageAccountType 'UltraSSD_LRS' -DiskIOPSReadWrite 5000 -DiskMBpsReadWrite 200

Первая команда создает объект виртуальной машины и сохраняет его в переменной $VirtualMachine. Команда назначает имя и размер виртуальной машине. Вторая команда добавляет диск данных UltraSSD с пользовательскими операциями ввода-вывода (операции ввода-вывода в секунду) равным 5000, а пропускная способность — 200 МБ в секунду. Эти параметры позволяют точно настроить производительность диска для UltraSSD_LRS и PremiumV2_LRS типов учетных записей хранения во время неявного создания диска.

Параметры

-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

-DiskIOPSReadWrite

Указывает Read-Write операций ввода-вывода (операции ввода-вывода в секунду) для диска, когда StorageAccountType UltraSSD_LRS или PremiumV2_LRS.

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

Тип:

Nullable<T>[Int64]

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

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

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

-DiskMBpsReadWrite

Указывает пропускную способность в МБ в секунду для диска, если StorageAccountType UltraSSD_LRS или PremiumV2_LRS.

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

Тип:

Nullable<T>[Int64]

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

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

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