Add-AzVhd
Отправляет виртуальный жесткий диск с локального компьютера в 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 , Add-AzVhd преобразует любой VHDX-файл в VHD-файл и изменит размер перед отправкой.
Чтобы разрешить эту функцию, необходимо enable 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
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-BaseImageUriToPatch
Задает универсальный код ресурса (URI) для большого двоичного объекта базового образа в Хранилище BLOB-объектов Azure.
SAS можно указать в качестве значения этого параметра.
Свойства параметров
Тип: Uri
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: бс
Наборы параметров
DefaultParameterSet
Position: 4
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DataAccessAuthMode
Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок. Возможные варианты: "AzureActiveDirectory" и "Нет".
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
DirectUploadToManagedDiskSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Destination
Задает универсальный код ресурса (URI) большого двоичного объекта в Хранилище BLOB-объектов.
Параметр поддерживает универсальный код ресурса (URI) SAS, хотя назначение исправлений не может быть универсальным кодом ресурса (URI) SAS.
Свойства параметров
Тип: Uri
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: dst
Наборы параметров
DefaultParameterSet
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DiskHyperVGeneration
Создание гипервизора виртуальной машины. Применимо только к дискам ОС. Возможные значения: "V1", "V2".
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: HyperVGeneration
Наборы параметров
DirectUploadToManagedDiskSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DiskName
Имя нового управляемого диска
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
DirectUploadToManagedDiskSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DiskOsType
Тип операционной системы управляемого диска. Возможные значения: "Windows", "Linux".
Свойства параметров
Тип: OperatingSystemTypes
Значение по умолчанию: 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
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
DirectUploadToManagedDiskSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DiskZone
Список логических зон для диска.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Зона
Наборы параметров
DirectUploadToManagedDiskSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-LocalFilePath
Указывает путь к локальному VHD-файлу.
Свойства параметров
Тип: FileInfo
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: лф
Наборы параметров
(All)
Position: 2
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Location
Расположение нового управляемого диска
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
DirectUploadToManagedDiskSet
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-NumberOfUploaderThreads
Указывает количество потоков отправки, используемых при отправке VHD-файла.
Свойства параметров
Тип: Nullable<T> [ Int32 ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Й
Наборы параметров
(All)
Position: 3
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-OverWrite
Указывает, что этот командлет перезаписывает существующий большой двоичный объект в указанном URI назначения, если он существует.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: o
Наборы параметров
DefaultParameterSet
Position: 5
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-ResourceGroupName
Указывает имя группы ресурсов виртуальной машины.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-SkipResizing
Пропускает изменение размера VHD-файла.
Пользователи, которые хотят отправить VHD-файлы с неправильным размером (а не N * Mib + 512 байт) в большой двоичный объект, может использовать этот параметр коммутатора.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: 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 .
Выходные данные