Save-AzVMImage

  • Référence
Module:
Az.Compute

Enregistre une machine virtuelle en tant que VMImage.

Syntax

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Id

Spécifie l’ID de ressource de la machine virtuelle.

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

-Name

Spécifie un nom.

Type:String
Aliases:VMName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

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

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:VirtualHardDiskNamePrefix
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

SwitchParameter

Sorties

PSComputeLongRunningOperation