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 |