Partager via


Save-AzureRmVhd

Enregistre les images .vhd téléchargées localement.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Save-AzureRmVhd
    [-ResourceGroupName] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzureRmVhd
    [-StorageKey] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

L’applet de commande Save-AzureRmVhd enregistre les images .vhd à partir d’un objet blob où elles sont stockées dans un fichier. Vous pouvez spécifier le nombre de threads de téléchargement que le processus utilise et s’il faut remplacer un fichier qui existe déjà. Cette applet de commande télécharge le contenu tel qu’il est. Il n’applique aucune conversion de format de disque dur virtuel (VHD).

Exemples

Exemple 1 : Télécharger une image

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"

Cette commande télécharge un fichier .vhd et le stocke dans le chemin local C :\vhd\Win7Image.vhd.

Exemple 2 : Télécharger une image et remplacer le fichier local

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"

Cette commande télécharge un fichier .vhd et le stocke dans le chemin local. La commande inclut le paramètre Overwrite . Par conséquent, si C :\vhd\Win7Image.vhd existe déjà, cette commande la remplace.

Exemple 3 : Télécharger une image à l’aide d’un nombre spécifié de threads

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"

Cette commande télécharge un fichier .vhd et le stocke dans le chemin local. La commande spécifie la valeur 32 pour le paramètre NumberOfThreads . Par conséquent, l’applet de commande utilise 32 threads pour cette action.

Exemple 4 : Télécharger une image et spécifier la clé de stockage

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw==" -ResourceGroupName "rgname"

Cette commande télécharge un fichier .vhd et spécifie la clé de stockage.

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

-DefaultProfile

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

Type:IAzureContextContainer
Alias: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

-LocalFilePath

Spécifie le chemin d’accès du fichier local de l’image enregistrée.

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

-NumberOfThreads

Spécifie le nombre de threads de téléchargement que cette applet de commande utilise pendant le téléchargement.

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

-OverWrite

Indique que cette applet de commande remplace le fichier spécifié par le fichier LocalFilePath s’il existe.

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

-ResourceGroupName

Spécifie le nom du groupe de ressources du compte de stockage.

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

-SourceUri

Spécifie l’URI (Uniform Resource Identifier) de l’objet blob dans Azure.

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

-StorageKey

Spécifie la clé de stockage du compte de stockage d’objets blob. Si vous ne spécifiez pas de clé, cette applet de commande tente de déterminer la clé de stockage du compte dans SourceUri à partir d’Azure.

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

Entrées

String

Uri

Sorties

VhdDownloadContext