Partager via

Add-AzVhd

Module:
Az.Compute Module

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

Syntaxe

DefaultParameterSet (Par défaut) 

Add-AzVhd
    [-ResourceGroupName] <String>
    [-Destination] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfUploaderThreads] <Int32>]
    [[-BaseImageUriToPatch] <Uri>]
    [-OverWrite]
    [-SkipResizing]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

DirectUploadToManagedDiskSet 

Add-AzVhd
    [-ResourceGroupName] <String>
    [-LocalFilePath] <FileInfo>
    [-Location] <String>
    [[-NumberOfUploaderThreads] <Int32>]
    -DiskName <String>
    [-DiskSku <String>]
    [-DiskZone <String[]>]
    [-DiskHyperVGeneration <String>]
    [-DiskOsType <OperatingSystemTypes>]
    [-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 pour charger 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&amp;se=2013-01-09T23%3A10%3A49Z&amp;sr=b&amp;sp=w&amp;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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Uri
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Bs

Jeux de paramètres

DefaultParameterSet
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Uri
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Dst

Jeux de paramètres

DefaultParameterSet
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:HyperVGeneration

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DiskName

Nom du nouveau disque managé

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DiskOsType

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

Propriétés du paramètre

Type:OperatingSystemTypes
Valeur par défaut:None
Valeurs acceptées:Windows, Linux
Prend en charge les caractères génériques:False
DontShow:False
Alias:OsType

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DiskSku

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DiskZone

Liste de zones logiques pour le disque.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Zone

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-LocalFilePath

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

Propriétés du paramètre

Type:FileInfo
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Si

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Location

Emplacement du nouveau disque managé

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DirectUploadToManagedDiskSet
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NumberOfUploaderThreads

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ième

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:o

Jeux de paramètres

DefaultParameterSet
Position:5
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Uri

FileInfo

Nullable<T>

SwitchParameter

Sorties

VhdUploadContext