Partilhar via


Save-AzureRmVhd

Salva imagens .vhd baixadas localmente.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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>]

Description

O cmdlet Save-AzureRmVhd salva imagens .vhd de um blob onde elas são armazenadas em um arquivo. Você pode especificar o número de threads do downloader que o processo usa e se deseja substituir um arquivo que já existe. Este cmdlet baixa o conteúdo tal como está. Ele não aplica qualquer conversão de formato de disco rígido virtual (VHD).

Exemplos

Exemplo 1: Descarregar uma imagem

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

Este comando baixa um arquivo .vhd e o armazena no caminho local C:\vhd\Win7Image.vhd.

Exemplo 2: Baixar uma imagem e substituir o arquivo local

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

Este comando baixa um arquivo .vhd e o armazena no caminho local. O comando inclui o parâmetro Overwrite . Portanto, se C:\vhd\Win7Image.vhd já existir, este comando o substituirá.

Exemplo 3: Baixar uma imagem usando um número especificado de threads

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

Este comando baixa um arquivo .vhd e o armazena no caminho local. O comando especifica um valor de 32 para o parâmetro NumberOfThreads . Portanto, o cmdlet usa 32 threads para essa ação.

Exemplo 4: Transferir uma imagem e especificar a chave de armazenamento

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

Este comando baixa um arquivo .vhd e especifica a chave de armazenamento.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano e retorne um Job para acompanhar o progresso.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LocalFilePath

Especifica o caminho do arquivo local da imagem salva.

Tipo:FileInfo
Aliases:lf
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NumberOfThreads

Especifica o número de threads de download que esse cmdlet usa durante o download.

Tipo:Int32
Aliases:th
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OverWrite

Indica que esse cmdlet substitui o arquivo especificado pelo arquivo LocalFilePath , se ele existir.

Tipo:SwitchParameter
Aliases:o
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome do grupo de recursos da conta de armazenamento.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SourceUri

Especifica o URI (Uniform Resource Identifier) do blob em Azure.

Tipo:Uri
Aliases:src, Source
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageKey

Especifica a chave de armazenamento da conta de armazenamento de blob. Se você não especificar uma chave, esse cmdlet tentará determinar a chave de armazenamento da conta no SourceUri do Azure.

Tipo:String
Aliases:sk
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Uri

Saídas

VhdDownloadContext