Partager via


Save-AzureRmVMImage

Enregistre une machine virtuelle en tant que VMImage.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

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

Description

L’applet de commande Save-AzureRmVMImage enregistre une machine virtuelle en tant que VMImage. Avant de créer une image de machine virtuelle, sysprep la machine virtuelle, puis la marque comme généralisée à l’aide de l’applet de commande Set-AzureRmVM. 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

PS C:\> Set-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized 
PS C:\> Save-AzureRmVMImage -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.

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
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:AzureRmContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire: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
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Id

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

Type:String
Position:0
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie un nom.

Type:String
Aliases:VMName
Position:1
valeur par défaut:None
Obligatoire: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
valeur par défaut:None
Obligatoire: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
valeur par défaut:None
Obligatoire: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
valeur par défaut:None
Obligatoire: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
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

SwitchParameter

Sorties

PSComputeLongRunningOperation