Add-AzVhd

  • Riferimento
Modulo:
Az.Compute

Carica un disco rigido virtuale da un computer locale in Azure (disco gestito o BLOB).

Sintassi

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

Descrizione

Il cmdlet Add-AzVhd carica un disco rigido virtuale locale in un disco gestito o in un account di archiviazione BLOB.

Il disco rigido virtuale caricato deve essere un file con estensione vhd e dimensioni N * Mib + 512 byte. Usando la funzionalità Hyper-V , Add-AzVhd convertirà qualsiasi file con estensione vhdx in un file con estensione vhd e ridimensionarlo prima del caricamento. Per consentire questa funzionalità, è necessario abilitare Hyper-V. Se si usa un computer Linux o si sceglie di non usare questa funzionalità, sarà necessario ridimensionare manualmente il file VHD. Inoltre, Add-AzVhd convertirà i file VHD di dimensioni dinamiche in dimensioni fisse durante il caricamento. Usare -Verbose per seguire tutto il processo.

Per il set di parametri predefinito (caricamento nel BLOB), è supportata anche la possibilità di caricare una versione con patch di un file con estensione vhd locale. Quando è già stato caricato un disco rigido virtuale di base, è possibile caricare dischi diversi che usano l'immagine di base come padre. È supportato anche l'URI della firma di accesso condiviso ( SAS).

Per Il caricamento diretto nel set di parametri del disco gestito, i parametri ResourceGroupName, DiskName, Location, DiskSku e Zone verranno usati per creare un nuovo disco, quindi il disco rigido virtuale verrà caricato.

Altre informazioni sull'uso di Add-AzVhd per caricare direttamente in un disco gestito.

Per i file VHD maggiori di 50 GB, è consigliabile usare AzCopy per un caricamento più rapido.

Esempio

Esempio 1: Aggiungere un file VHD a un BLOB

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

Questo comando aggiunge un file con estensione vhd a un account di archiviazione.

Esempio 2: Aggiungere un file VHD a un BLOB e sovrascrivere la destinazione

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

Questo comando aggiunge un file con estensione vhd a un account di archiviazione. Il comando sovrascrive un file esistente.

Esempio 3: Aggiungere un file VHD a un BLOB con numero di thread specificati

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

Questo comando aggiunge un file con estensione vhd a un account di archiviazione. Il comando specifica il numero di thread da usare per caricare il file.

Esempio 4: Aggiungere un file VHD a un BLOB e specificare l'URI di firma di accesso condiviso

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"

Questo comando aggiunge un file con estensione vhd a un account di archiviazione e specifica l'URI di firma di accesso condiviso.

Esempio 5: aggiungere un file VHD direttamente a un disco gestito.

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

Questo comando crea un disco gestito con resourceGroupName, Location e DiskName specificati; e carica il file VHD.

Esempio 6: aggiungere un file VHD direttamente a un disco più configurato.

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

Questo comando tenterà di convertire prima il file vhdx in file vhd usando Hyper-V. Se Hyper-V non viene trovato, verrà restituito un errore che chiede di usare un file vhd. Dopo aver completato la conversione, verrà creato un disco gestito con parametri forniti e quindi caricato il file vhd.

Parametri

-AsJob

Eseguire il cmdlet in background e restituire un processo per tenere traccia dello stato di avanzamento.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseImageUriToPatch

Specifica l'URI di un BLOB di immagini di base in Archiviazione BLOB di Azure. È possibile specificare una firma di accesso condiviso come valore per questo parametro.

Type:Uri
Aliases:bs
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DataAccessAuthMode

Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o uno snapshot. Le opzioni possibili sono: "AzureActiveDirectory" e "None".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Specifica l'URI di un BLOB nell'Archiviazione BLOB. Il parametro supporta l'URI di firma di accesso condiviso, anche se la destinazione degli scenari di applicazione di patch non può essere un URI di firma di accesso condiviso.

Type:Uri
Aliases:dst
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskHyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. I valori posssible sono: 'V1', 'V2'.

Type:String
Aliases:HyperVGeneration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskName

Nome del nuovo disco gestito

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskOsType

Tipo di sistema operativo del disco gestito. I valori possibili sono: 'Windows', 'Linux'.

Type:OperatingSystemTypes
Aliases:OsType
Accepted values:Windows, Linux
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskSku

Sku per il disco gestito. Opzioni: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskZone

Elenco di zone logiche per Disco.

Type:String[]
Aliases:Zone
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LocalFilePath

Specifica il percorso del file con estensione vhd locale.

Type:FileInfo
Aliases:lf
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Percorso del nuovo disco gestito

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NumberOfUploaderThreads

Specifica il numero di thread del caricatore da usare durante il caricamento del file con estensione vhd.

Type:Nullable<T>[Int32]
Aliases:th
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OverWrite

Indica che questo cmdlet sovrascrive un BLOB esistente nell'URI di destinazione specificato, se presente.

Type:SwitchParameter
Aliases:o
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il nome del gruppo di risorse della macchina virtuale.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipResizing

Ignora il ridimensionamento del file VHD. Gli utenti che desiderano caricare un file VHD con dimensioni non allineate (non N * Mib + 512 byte) in un BLOB possono usare questo parametro switch.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Uri

FileInfo

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

SwitchParameter

Output

VhdUploadContext