Partager via

Add-AzVhd

  • Référence
Module:
Az.Compute

Charge un disque dur virtuel à partir d’une machine locale vers Azure (disque managé ou objet blob).

Syntaxe

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

L’applet de commande Add-AzVhd charge un disque dur virtuel local sur un disque managé ou un compte de stockage d’objets blob.

Le disque dur virtuel en cours de chargement doit être un fichier .vhd et de taille N * Mib + 512 octets. À l’aide de la fonctionnalité Hyper-V , Add-AzVhd convertit tout fichier .vhdx en fichier .vhd et redimensionne avant le chargement. Pour autoriser cette fonctionnalité, vous devez activer Hyper-V. Si vous utilisez une machine Linux ou si vous choisissez de ne pas utiliser cette fonctionnalité, vous devez redimensionner le fichier de disque dur virtuel manuellement. En outre, Add-AzVhd convertit les fichiers de disque dur virtuel de taille dynamique en taille fixe pendant le chargement. Permet -Verbose de suivre tout le processus.

Pour l’ensemble de paramètres par défaut (chargement sur blob), il est également possible de charger une version corrigée d’un fichier .vhd local. Lorsqu’un disque dur virtuel de base a déjà été chargé, vous pouvez charger des disques de différenciation qui utilisent l’image de base comme parent. L’URI de signature d’accès partagé (SAP) est également pris en charge.

Pour le jeu de paramètres de chargement direct sur disque managé, les paramètres : ResourceGroupName, DiskName, Location, DiskSku et Zone seront utilisés pour créer un disque, puis le disque dur virtuel sera chargé vers celui-ci.

Pour plus d’informations sur l’utilisation de Add-AzVhd, téléchargez directement sur un disque managé.

Pour les fichiers VHD supérieurs à 50 Go, nous vous recommandons d’utiliser AzCopy pour accélérer le chargement.

Exemples

Exemple 1 : Ajouter un fichier de disque dur virtuel à un objet blob

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

Cette commande ajoute un fichier .vhd à un compte de stockage.

Exemple 2 : Ajouter un fichier VHD à un objet blob et remplacer la destination

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

Cette commande ajoute un fichier .vhd à un compte de stockage. La commande remplace un fichier existant.

Exemple 3 : Ajouter un fichier VHD à un objet blob avec le nombre de threads spécifiés

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

Cette commande ajoute un fichier .vhd à un compte de stockage. La commande spécifie le nombre de threads à utiliser pour charger le fichier.

Exemple 4 : Ajouter un fichier VHD à un objet blob et spécifier l’URI SAP

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"

Cette commande ajoute un fichier .vhd à un compte de stockage et spécifie l’URI SAP.

Exemple 5 : Ajoutez un fichier de disque dur virtuel directement à un disque managé.

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

Cette commande crée un disque managé avec ResourceGroupName, Location et DiskName donnés ; et charge le fichier VHD sur celui-ci.

Exemple 6 : Ajoutez un fichier de disque dur virtuel directement à un disque plus configuré.

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

Cette commande a essayé de convertir le fichier vhdx en fichier vhd en premier à l’aide d’Hyper-V. Si Hyper-V est introuvable, il retourne une erreur demandant d’utiliser un fichier vhd. Une fois la conversion réussie, elle crée un disque managé avec des paramètres fournis, puis charge le fichier vhd.

Paramètres

-AsJob

Exécutez l’applet de commande en arrière-plan et retournez un travail pour suivre la progression.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BaseImageUriToPatch

Spécifie l’URI d’un objet blob d’images de base dans Stockage Blob Azure. Une SAP peut être spécifiée comme valeur pour ce paramètre.

Type:Uri
Alias:bs
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané. Les options possibles sont les suivantes : « AzureActiveDirectory » et « None ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Destination

Spécifie l’URI d’un objet blob dans Le Stockage Blob. Le paramètre prend en charge l’URI SAS, bien que la destination des scénarios de mise à jour corrective ne puisse pas être un URI SAP.

Type:Uri
Alias:dst
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskHyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. Les valeurs possibles sont : « V1 », « V2 ».

Type:String
Alias:HyperVGeneration
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskName

Nom du nouveau disque managé

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskOsType

Type de système d’exploitation du disque managé. Les valeurs possibles sont : « Windows », « Linux ».

Type:OperatingSystemTypes
Alias:OsType
Valeurs acceptées:Windows, Linux
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskSku

Référence SKU pour disque managé. Options : Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskZone

Liste de zones logiques pour le disque.

Type:String[]
Alias:Zone
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LocalFilePath

Spécifie le chemin d’accès du fichier .vhd local.

Type:FileInfo
Alias:lf
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Location

Emplacement du nouveau disque managé

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NumberOfUploaderThreads

Spécifie le nombre de threads de chargement à utiliser lors du chargement du fichier .vhd.

Type:Nullable<T>[Int32]
Alias:th
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OverWrite

Indique que cette applet de commande remplace un objet blob existant dans l’URI de destination spécifié, s’il en existe un.

Type:SwitchParameter
Alias:o
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources de la machine virtuelle.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SkipResizing

Ignore le redimensionnement du fichier de disque dur virtuel. Les utilisateurs qui souhaitent charger des fichiers VHD dont la taille est mal alignée (et non N * Mib + 512 octets) sur un objet blob peuvent utiliser ce paramètre de commutateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Uri

FileInfo

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

SwitchParameter

Sorties

VhdUploadContext