Partager via

Save-AzVMImage

  • Référence
Module:
Az.Compute

Enregistre une machine virtuelle en tant que VMImage.

Syntaxe

Save-AzVMImage
    [-Name] <String>
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-ResourceGroupName] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-Id] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

L’applet de commande Save-AzVMImage enregistre une machine virtuelle en tant que VMImage. Avant de créer une image de machine virtuelle, sysprep la machine virtuelle, puis de la marquer comme généralisée à l’aide de l’applet de commande Set-AzVM. La sortie de cette applet de commande est un modèle JSON (JavaScript Object Notation). Vous pouvez déployer des machines virtuelles à partir de votre image capturée.

Exemples

Exemple 1 : Capturer une machine virtuelle

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized 
Save-AzVMImage -ResourceGroupName "ResourceGroup11" -VMName "VirtualMachine07" -DestinationContainerName "VMContainer01" -VHDNamePrefix "VM07"

La première commande marque la machine virtuelle nommée VirtualMachine07 comme généralisée. La deuxième commande capture une machine virtuelle nommée VirtualMachine07 en tant que VMImage. La propriété Output retourne un modèle JSON.

Exemple 2

Enregistre une machine virtuelle en tant que VMImage. (généré automatiquement)

Save-AzVMImage -DestinationContainerName 'VMContainer01' -Name 'VirtualMachine07' -Path '/home/admin/.ssh/authorized_keys' -ResourceGroupName 'ResourceGroup11' -VHDNamePrefix 'VM07'

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

-DestinationContainerName

Spécifie le nom d’un conteneur à l’intérieur du conteneur « système » que vous souhaitez contenir vos images. Si le conteneur n’existe pas, il est créé pour vous. Les disques durs virtuels (VHD) qui constituent vmImage résident dans le conteneur spécifié par ce paramètre. Si les disques durs virtuels sont répartis sur plusieurs comptes de stockage, cette applet de commande crée un conteneur qui a ce nom dans chaque compte de stockage. L’URL de l’image enregistrée est similaire à : https://< storageAccountName.blob.core.windows.net/system/Microsoft.Compute/Images/>< imagesContainer>/<vhdPrefix-osDisk.xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx.vhd>.

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

-Id

Spécifie l’ID de ressource 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

-Name

Spécifie un nom.

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

-Overwrite

Indique que cette applet de commande remplace tous les disques durs virtuels qui ont le même préfixe dans le conteneur de destination.

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

-Path

Chemin d’accès au fichier dans lequel le modèle de l’image capturée est stocké.

Type:String
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

-VHDNamePrefix

Spécifie le préfixe dans le nom des objets blob qui constituent le profil de stockage de VMImage. Par exemple, un préfixe vhdPrefix pour un disque de système d’exploitation entraîne le nom vhdPrefix-osdisk.<guid.vhd>.

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

Entrées

String

SwitchParameter

Sorties

PSComputeLongRunningOperation