Partager via


Save-AzureVMImage

Capture et enregistre l’image d’une machine virtuelle Azure arrêtée.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Save-AzureVMImage
    [-ServiceName] <String>
    [-Name] <String>
    [-ImageName] <String>
    [[-ImageLabel] <String>]
    [[-OSState] <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Save-AzureVMImage capture et enregistre l’image d’une machine virtuelle Azure arrêtée. Pour les machines virtuelles Windows, exécutez l’outil Sysprep pour préparer l’image avant sa capture. Une fois l’image capturée, la machine virtuelle est supprimée.

Exemples

Exemple 1 : Enregistrer une machine virtuelle existante, puis la supprimer d’un déploiement

PS C:\> Save-AzureVMImage -ServiceName "MyService" -Name "MyVM" -NewImageName "MyBaseImage" -NewImageLabel "MyBaseVM"

Cette commande capture une machine virtuelle existante et la supprime du déploiement.

Paramètres

-ImageLabel

Spécifie l’étiquette de l’image de machine virtuelle.

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

-ImageName

Spécifie le nom de l’image de machine virtuelle.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-Name

Spécifie le nom de la machine virtuelle source.

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

-OSState

Spécifie l’état du système d’opération pour l’image de machine virtuelle. Utilisez ce paramètre si vous envisagez de capturer une image de machine virtuelle sur Azure.

Les valeurs valides sont :

  • Généralisée
  • Spécialisée
Type:String
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ServiceName

Spécifie le nom du service Azure.

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