Add-AzVhd

  • Referência
Módulo:
Az.Compute

Carrega um disco rígido virtual de um computador local para o Azure (disco gerenciado ou blob).

Sintaxe

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

Description

O cmdlet Add-AzVhd carrega um disco rígido virtual local em um disco gerenciado ou em uma conta de armazenamento de blobs.

O disco rígido virtual que está sendo carregado precisa ser um arquivo .vhd e no tamanho N * Mib + 512 bytes. Usando a funcionalidade Hyper-V , Add-AzVhd converterá qualquer arquivo .vhdx em um arquivo .vhd e redimensionará antes de carregar. Para permitir essa funcionalidade, você precisará habilitar o Hyper-V. Se você estiver usando um computador Linux ou optar por não usar essa funcionalidade, precisará redimensionar o arquivo VHD manualmente. Além disso, o Add-AzVhd converterá arquivos VHD de tamanho dinâmico em tamanho fixo durante o upload. Use -Verbose para acompanhar todo o processo.

Para o conjunto de parâmetros padrão (carregar no blob), também há suporte para a capacidade de carregar uma versão corrigida de um arquivo .vhd local. Quando um disco rígido virtual base já tiver sido carregado, você poderá carregar discos diferenciais que usam a imagem base como pai. O URI de assinatura de acesso compartilhado (SAS) também é compatível.

Para o conjunto de parâmetros de Carregamento Direto para o Disco Gerenciado, os parâmetros: ResourceGroupName, DiskName, Location, DiskSku e Zone serão usados para criar um novo disco e, em seguida, o disco rígido virtual será carregado nele.

Mais informações sobre como usar Add-AzVhd para carregar diretamente em um disco gerenciado.

Para arquivos VHD maiores que 50 GB, recomendamos usar o AzCopy para carregamento mais rápido.

Exemplos

Exemplo 1: Adicionar um arquivo VHD a um blob

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

Esse comando adiciona um arquivo .vhd a uma conta de armazenamento.

Exemplo 2: Adicionar um arquivo VHD a um blob e substituir o destino

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

Esse comando adiciona um arquivo .vhd a uma conta de armazenamento. O comando substitui um arquivo existente.

Exemplo 3: Adicionar um arquivo VHD a um blob com o número de threads especificado

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

Esse comando adiciona um arquivo .vhd a uma conta de armazenamento. O comando especifica o número de threads a serem usados para carregar o arquivo.

Exemplo 4: Adicionar um arquivo VHD a um blob e especificar o 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"

Esse comando adiciona um arquivo .vhd a uma conta de armazenamento e especifica o URI SAS.

Exemplo 5: adicionar um arquivo VHD diretamente a um disco gerenciado.

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

Esse comando cria um disco gerenciado com ResourceGroupName, Location e DiskName fornecidos; e carrega o arquivo VHD para ele.

Exemplo 6: adicione um arquivo VHD diretamente a um disco mais configurado.

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

Este comando tentará converter o arquivo vhdx em arquivo vhd primeiro usando o Hyper-V. Se o Hyper-V não for encontrado, ele retornará um erro solicitando o uso de um arquivo vhd. Após a conversão bem-sucedida, ele criará um disco gerenciado com os parâmetros fornecidos e, em seguida, carregará o arquivo vhd.

Parâmetros

-AsJob

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BaseImageUriToPatch

Especifica o URI para um blob de imagem base no Armazenamento de Blobs do Azure. Uma SAS pode ser especificada como o valor para esse parâmetro.

Tipo:Uri
Aliases:bs
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo. As opções possíveis são: "AzureActiveDirectory" e "None".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Destination

Especifica o URI de um blob no Armazenamento de Blobs. O parâmetro dá suporte ao URI SAS, embora o destino dos cenários de aplicação de patch não possa ser um URI SAS.

Tipo:Uri
Aliases:dst
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskHyperVGeneration

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. Os valores possíveis são: 'V1', 'V2'.

Tipo:String
Aliases:HyperVGeneration
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskName

Nome do novo disco gerenciado

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskOsType

O tipo de sistema operacional do disco gerenciado. Os valores possíveis são: 'Windows', 'Linux'.

Tipo:OperatingSystemTypes
Aliases:OsType
Valores aceitos:Windows, Linux
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskSku

SKU para disco gerenciado. Opções: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskZone

A lista de zonas lógicas para Disco.

Tipo:String[]
Aliases:Zone
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LocalFilePath

Especifica o caminho do arquivo .vhd local.

Tipo:FileInfo
Aliases:lf
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

Local do novo Disco Gerenciado

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NumberOfUploaderThreads

Especifica o número de threads de upload a serem usados ao carregar o arquivo .vhd.

Tipo:Nullable<T>[Int32]
Aliases:th
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OverWrite

Indica que esse cmdlet substitui um blob existente no URI de destino especificado, se houver.

Tipo:SwitchParameter
Aliases:o
Cargo:5
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkipResizing

Ignora o redimensionamento do arquivo VHD. Os usuários que desejam carregar arquivos VHD com tamanho desalinhado (não N * Mib + 512 bytes) para um blob podem usar esse parâmetro switch.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Uri

FileInfo

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

SwitchParameter

Saídas

VhdUploadContext