Add-AzVhd

  • Referência
Módulo:
Az.Compute

Carrega um disco rígido virtual de uma máquina 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 blob.

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 irá 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 uma máquina Linux ou optar por não usar essa funcionalidade, será necessário redimensionar o arquivo VHD manualmente. Além disso, Add-AzVhd irá converter arquivos VHD de tamanho dinâmico para tamanho fixo durante o upload. Use -Verbose para acompanhar todo o processo.

Para o conjunto de parâmetros padrão (upload para blob), também é suportada a capacidade de carregar uma versão corrigida de um arquivo .vhd local. Quando um disco rígido virtual de 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 é suportado.

Para o conjunto de parâmetros Direct Upload to Managed Disk, 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 ficheiros VHD com mais de 50 GB, recomendamos a utilização do AzCopy para um 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"

Este 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

Este 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 especificados

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

Este 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"

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

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

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

Este comando cria um disco gerenciado com determinado ResourceGroupName, Location e DiskName; 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 para o 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 Job para acompanhar o progresso.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DataAccessAuthMode

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Destination

Especifica o URI de um blob no Armazenamento de Blob. O parâmetro suporta URI SAS, embora o destino dos cenários de aplicação de patches não possa ser um URI SAS.

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

-DiskHyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO. Os valores possíveis são: 'V1', 'V2'.

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

-DiskName

Nome do novo disco gerenciado

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

-DiskOsType

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

Tipo:OperatingSystemTypes
Aliases:OsType
Valores aceites:Windows, Linux
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DiskSku

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

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

-DiskZone

A lista de zonas lógicas para disco.

Tipo:String[]
Aliases:Zone
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LocalFilePath

Especifica o caminho do arquivo .vhd local.

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

-Location

Localização do novo disco gerenciado

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

-NumberOfUploaderThreads

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

Tipo:Nullable<T>[Int32]
Aliases:th
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OverWrite

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

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

-ResourceGroupName

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

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

-SkipResizing

Ignora o redimensionamento do arquivo VHD. Os usuários que desejam carregar um arquivo VHD que tem seu tamanho desalinhado (não N * Mib + 512 bytes) para um blob pode usar este parâmetro de opção.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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