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

Add-AzureDataDisk

  • Ссылка
Модуль:
Azure

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

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Описание

Командлет Add-AzureDataDisk добавляет новый или существующий диск данных в объект виртуальной машины Azure. Используйте параметр CreateNew для создания нового диска данных с указанным размером и меткой. Используйте параметр import для подключения существующего диска из репозитория образов. Используйте параметр ImportFrom для подключения существующего диска из большого двоичного объекта в учетной записи хранения. Можно указать режим кэша узла подключенного диска данных.

Примеры

Пример 1. Импорт диска данных из репозитория

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

Эта команда получает объект виртуальной машины для виртуальной машины с именем VirtualMachine07 в облачной службе ContosoService с помощью командлета Get-AzureVM . Команда передает его текущему командлету с помощью оператора конвейера. Эта команда подключает существующий диск данных из репозитория к виртуальной машине. Диск данных имеет LUN 0. Команда обновляет виртуальную машину, чтобы отразить изменения с помощью командлета Update-AzureVM .

Пример 2. Добавление нового диска данных

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

Эта команда получает объект виртуальной машины для виртуальной машины с именем VirtualMachine08. Команда передает ее текущему командлету. Эта команда подключает новый диск данных с именем MyNewDisk.vhd. Командлет создает диск в контейнере vhds в учетной записи хранения по умолчанию текущей подписки. Команда обновляет виртуальную машину, чтобы отразить изменения.

Пример 3. Добавление диска данных из указанного расположения

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

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

Параметры

-CreateNew

Указывает, что этот командлет создает диск данных.

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

-DiskLabel

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

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

-DiskName

Указывает имя диска данных в репозитории дисков.

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

-DiskSizeInGB

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

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

-HostCaching

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

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

-Import

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

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

-ImportFrom

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

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

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Допустимые значения для этого параметра:

  • Продолжить
  • Пропустить
  • Спрашивать
  • SilentlyContinue
  • Остановить
  • Приостановить
Тип:ActionPreference
Aliases:infa
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InformationVariable

Указывает переменную сведений.

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

-LUN

Указывает логический номер единицы (LUN) для диска данных на виртуальной машине. Допустимые значения: от 0 до 15. Каждый диск данных должен иметь уникальный LUN.

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

-MediaLocation

Указывает расположение большого двоичного объекта в учетной записи хранения Azure, в которой этот командлет хранит диск данных. Если расположение не указано, командлет сохраняет диск данных в контейнере vhds в учетной записи хранения по умолчанию для текущей подписки. Если контейнер vhds не существует, командлет создает контейнер vhds.

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

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

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

-VM

Указывает объект виртуальной машины, к которому этот командлет подключает диск данных. Чтобы получить объект виртуальной машины, используйте командлет Get-AzureVM .

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