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


Save-AzureRmVhd

Сохраняет скачанные образы VHD локально.

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

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

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

Синтаксис

Save-AzureRmVhd
    [-ResourceGroupName] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzureRmVhd
    [-StorageKey] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Save-AzureRmVhd сохраняет образы VHD из большого двоичного объекта, в котором они хранятся в файле. Можно указать количество потоков скачивания, которые использует процесс и следует ли заменить файл, который уже существует. Этот командлет загружает содержимое по мере его выполнения. Он не применяет преобразование формата виртуального жесткого диска (VHD).

Примеры

Пример 1. Скачивание образа

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"

Эта команда скачивает VHD-файл и сохраняет его в локальном пути C:\vhd\Win7Image.vhd.

Пример 2. Скачивание образа и перезапись локального файла

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"

Эта команда скачивает VHD-файл и сохраняет его в локальном пути. Команда включает параметр Overwrite . Таким образом, если C:\vhd\Win7Image.vhd уже существует, эта команда заменяет ее.

Пример 3. Скачивание изображения с помощью указанного количества потоков

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"

Эта команда скачивает VHD-файл и сохраняет его в локальном пути. Команда задает значение 32 для параметра NumberOfThreads . Поэтому командлет использует 32 потока для этого действия.

Пример 4. Скачивание образа и указание ключа хранилища

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw==" -ResourceGroupName "rgname"

Эта команда скачивает VHD-файл и задает ключ хранилища.

Параметры

-AsJob

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

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

-DefaultProfile

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

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

-LocalFilePath

Указывает локальный путь к файлу сохраненного образа.

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

-NumberOfThreads

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

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

-OverWrite

Указывает, что этот командлет заменяет файл, указанный файлом LocalFilePath , если он существует.

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

-ResourceGroupName

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

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

-SourceUri

Указывает универсальный идентификатор ресурса (URI) большого двоичного объекта в Azure.

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

-StorageKey

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

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

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

String

Uri

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

VhdDownloadContext