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

Add-AzVhd

Модуль:
Az.Compute Module

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

Синтаксис

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

Add-AzVhd
    [-ResourceGroupName] <String>
    [-Destination] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfUploaderThreads] <Int32>]
    [[-BaseImageUriToPatch] <Uri>]
    [-OverWrite]
    [-SkipResizing]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

DirectUploadToManagedDiskSet 

Add-AzVhd
    [-ResourceGroupName] <String>
    [-LocalFilePath] <FileInfo>
    [-Location] <String>
    [[-NumberOfUploaderThreads] <Int32>]
    -DiskName <String>
    [-DiskSku <String>]
    [-DiskZone <String[]>]
    [-DiskHyperVGeneration <String>]
    [-DiskOsType <OperatingSystemTypes>]
    [-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&amp;se=2013-01-09T23%3A10%3A49Z&amp;sr=b&amp;sp=w&amp;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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-BaseImageUriToPatch

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

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

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

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

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

-DataAccessAuthMode

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

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

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

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

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

-DefaultProfile

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

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

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

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

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

-Destination

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

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

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

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

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

-DiskHyperVGeneration

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

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

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

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

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

-DiskName

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

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

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

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

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

-DiskOsType

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

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

Тип:OperatingSystemTypes
Default value:None
Допустимые значения:Windows, Linux
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:OsType

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

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

-DiskSku

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

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

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

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

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

-DiskZone

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

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

Тип:

String[]

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

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

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

-LocalFilePath

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

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

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

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

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

-Location

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

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

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

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

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

-NumberOfUploaderThreads

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

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

Тип:

Nullable<T>[Int32]

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

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

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

-OverWrite

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

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

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

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

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

-ResourceGroupName

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

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

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

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

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

-SkipResizing

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

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

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

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

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

CommonParameters

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

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

String

Uri

FileInfo

Nullable<T>

SwitchParameter

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

VhdUploadContext