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

Add-AzureRmVMDataDisk

  • Ссылка
Модуль:
AzureRM.Compute

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

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

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

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM

Первая команда получает существующий управляемый диск. Следующая команда получает существующую виртуальную машину Vmss, указанную именем группы ресурсов, именем виртуальной машины и идентификатором экземпляра. Следующая команда добавляет управляемый диск к виртуальной машине Vmss, хранящейся локально в $VmssVM. Последняя команда обновляет виртуальную машину Vmss с добавленным диском данных.

Параметры

-Caching

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

  • ReadOnly
  • Чтение и запись
  • Значение по умолчанию — 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:AzureRmContext, AzureCredential
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
Обязательно:True
Принять входные данные конвейера: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

-StorageAccountType

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

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

-VhdUri

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

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

-VirtualMachineScaleSetVM

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

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

-VM

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

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

-WriteAccelerator

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

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

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

PSVirtualMachine

PSVirtualMachineScaleSetVM

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

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

PSVirtualMachine

PSVirtualMachineScaleSetVM