Add-AzVhd

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

Отправляет виртуальный жесткий диск с локального компьютера в Azure (управляемый диск или большой двоичный объект).

Синтаксис

Add-AzVhd
   [-ResourceGroupName] <String>
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-SkipResizing]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVhd
   [-ResourceGroupName] <String>
   [-LocalFilePath] <FileInfo>
   -DiskName <String>
   [-Location] <String>
   [-DiskSku <String>]
   [-DiskZone <String[]>]
   [-DiskHyperVGeneration <String>]
   [-DiskOsType <OperatingSystemTypes>]
   [[-NumberOfUploaderThreads] <Int32>]
   [-DataAccessAuthMode <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Add-AzVhd отправляет локальный виртуальный жесткий диск на управляемый диск или учетную запись хранения BLOB-объектов.

Передаваемый виртуальный жесткий диск должен быть VHD-файлом и размером N * Mib + 512 байт. С помощью функций Hyper-V надстройка AzVhd преобразует любой VHDX-файл в VHD-файл и изменит размер перед отправкой. Чтобы разрешить эту функцию, необходимо включить Hyper-V. Если вы используете компьютер Linux или не используете эту функцию, необходимо вручную изменить размер VHD-файла. Кроме того, Add-AzVhd преобразует динамически размер VHD-файлов в фиксированный размер во время отправки. Используется -Verbose для выполнения всего процесса.

Для набора параметров по умолчанию (отправка в большой двоичный объект) также поддерживается возможность отправки исправленной версии локального VHD-файла. Когда базовый виртуальный жесткий диск уже загружен, вы можете отправить разностные диски, использующие базовый образ в качестве родительского. Также поддерживается универсальный код ресурса (URI) подписанного URL-адреса (SAS).

Для прямого отправки в набор параметров управляемого диска параметры: ResourceGroupName, DiskName, Location, DiskSku и Zone будут использоваться для создания нового диска, затем виртуальный жесткий диск будет отправлен в него.

Дополнительные сведения об использовании Add-AzVhd для непосредственной отправки на управляемый диск.

Для VHD-файлов, превышающих 50 ГБ, рекомендуется использовать AzCopy для ускорения отправки.

Примеры

Пример 1. Добавление VHD-файла в большой двоичный объект

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

Эта команда добавляет VHD-файл в учетную запись хранения.

Пример 2. Добавление VHD-файла в большой двоичный объект и перезапись назначения

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

Эта команда добавляет VHD-файл в учетную запись хранения. Команда перезаписывает существующий файл.

Пример 3. Добавление VHD-файла в большой двоичный объект с указанным числом потоков

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32

Эта команда добавляет VHD-файл в учетную запись хранения. Команда указывает количество потоков, используемых для отправки файла.

Пример 4. Добавление VHD-файла в большой двоичный объект и указание URI SAS

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd?st=2013-01 -09T22%3A15%3A49Z&se=2013-01-09T23%3A10%3A49Z&sr=b&sp=w&sig=13T9Ow%2FRJAMmhfO%2FaP3HhKKJ6AY093SmveO SIV4%2FR7w%3D" -LocalFilePath "C:\vhd\win7baseimage.vhd"

Эта команда добавляет VHD-файл в учетную запись хранения и задает универсальный код ресурса (URI) SAS.

Пример 5. Добавление VHD-файла непосредственно на управляемый диск.

Add-AzVhd -LocalFilePath C:\data.vhd -ResourceGroupName rgname -Location eastus -DiskName newDisk

Эта команда создает управляемый диск с заданным resourceGroupName, Location и DiskName; и отправляет VHD-файл в него.

Пример 6. Добавление VHD-файла непосредственно на более настроенный диск.

Add-AzVhd -LocalFilePath C:\Data.vhdx -ResourceGroupName rgname -Location eastus -DiskName newDisk -Zone 1 -DiskSku Premium_LRS

Эта команда попытается преобразовать vhdx-файл в VHD-файл сначала с помощью Hyper-V. Если Hyper-V не найден, он вернет ошибку с просьбой использовать VHD-файл. После успешного преобразования он создаст управляемый диск с предоставленными параметрами, а затем отправит VHD-файл.

Параметры

-AsJob

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

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

-BaseImageUriToPatch

Указывает универсальный код ресурса (URI) для большого двоичного объекта базового образа в Хранилище BLOB-объектов Azure. SAS можно указать в качестве значения этого параметра.

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

-DataAccessAuthMode

Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок. Возможные варианты: "AzureActiveDirectory" и "Нет".

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

-DefaultProfile

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

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

-Destination

Задает универсальный код ресурса (URI) большого двоичного объекта в хранилище BLOB-объектов. Параметр поддерживает универсальный код ресурса (URI) SAS, хотя назначение исправлений не может быть универсальным кодом ресурса (URI) SAS.

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

-DiskHyperVGeneration

Создание гипервизора виртуальной машины. Применимо только к дискам ОС. Допустимые значения: "V1", "V2".

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

-DiskName

Имя нового управляемого диска

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

-DiskOsType

Тип операционной системы управляемого диска. Возможные значения: "Windows", "Linux".

Тип:OperatingSystemTypes
Aliases:OsType
Допустимые значения:Windows, Linux
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskSku

SKU для управляемого диска. Параметры: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

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

-DiskZone

Список логических зон для диска.

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

-LocalFilePath

Указывает путь к локальному VHD-файлу.

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

-Location

Расположение нового управляемого диска

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

-NumberOfUploaderThreads

Указывает количество потоков отправки, используемых при отправке VHD-файла.

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

-OverWrite

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

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

-ResourceGroupName

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

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

-SkipResizing

Пропускает изменение размера VHD-файла. Пользователи, которые хотят отправить VHD-файлы с неправильным размером (а не N * Mib + 512 байт) в большой двоичный объект, может использовать этот параметр коммутатора.

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

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

String

Uri

FileInfo

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

SwitchParameter

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

VhdUploadContext