Partager via

Remove-AzureVMImage

  • Référence
Module:
Azure

Supprime une image du système d’exploitation du référentiel d’images.

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

Remove-AzureVMImage
      [-ImageName] <String>
      [-DeleteVHD]
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureVMImage supprime une image du système d’exploitation du référentiel d’images. Par défaut, cette applet de commande ne supprime pas l’objet blob d’images physiques associé du compte de stockage. Pour supprimer le disque dur virtuel associé (VHD), utilisez le paramètre DeleteVHD .

Exemples

Exemple 1 : Supprimer une image du référentiel d’images

PS C:\> Remove-AzureVMImage -ImageName "Image001"

Cette commande supprime l’image nommée Image001 du référentiel d’images.

Exemple 2 : Supprimer une image du référentiel d’images et également du disque dur virtuel

PS C:\> Remove-AzureVMImage -ImageName " Image001" -DeleteVHD

Cette commande supprime l’image nommée Image001 du référentiel d’images et supprime également l’image de disque dur virtuel physique du compte de stockage.

Exemple 3 : Définir un contexte d’abonnement, puis supprimer toutes les images

PS C:\> $SubsId = &lt;MySubscriptionID&gt;
PS C:\> $Cert = Get-AzureCertificate cert:\LocalMachine\MY\&lt;CertificateThumbprint&gt;
PS C:\> Get-AzureVMImage `
| Where-Object {$_.Label -match "Beta" }`
| Foreach-Object {Remove-AzureVMImage -ImageName $_.name }

Cette commande définit le contexte d’abonnement, puis supprime toutes les images du référentiel d’images dont l’étiquette inclut le nom Bêta.

Paramètres

-DeleteVHD

Indique que cette applet de commande supprime l’objet blob d’images VHD physique du compte de stockage.

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

-ImageName

Spécifie le système d’exploitation ou l’image de machine virtuelle à supprimer du référentiel d’images.

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

-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

-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