Partager via

Get-AzureVMImage

  • Référence
Module:
Azure

Obtient les propriétés d’une ou d’une liste de systèmes d’exploitation ou d’une image de machine virtuelle dans le référentiel d’images.

Remarque

Les applets de commande référencées dans cette documentation concernent la gestion des 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.

Syntax

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

Description

L’applet de commande Get-AzureVMImage obtient les propriétés d’une ou d’une liste de systèmes d’exploitation ou d’une image de machine virtuelle dans le référentiel d’images. L’applet de commande retourne des informations pour toutes les images du référentiel ou sur une image spécifique si son nom d’image est fourni.

Exemples

Exemple 1 : Obtenir un objet image spécifique à partir du référentiel d’images actuel.

PS C:\> Get-AzureVMImage -ImageName Image001

Cette commande obtient l’objet image nommé Image001 à partir du référentiel d’images actuel.

Exemple 2 : Obtenir toutes les images du référentiel d’images actuel

PS C:\> Get-AzureVMImage

Cette commande récupère toutes les images du référentiel d’images actuel.

Exemple 3 : Définir le contexte d’abonnement, puis obtenir toutes les images

PS C:\> $SubsId = <MySubscriptionID>
C:\PS>$Cert = Get-AzureCertificate cert:\LocalMachine\MY\<CertificateThumbprint>
C:\PS>$MyOSImages = Get-AzureVMImage

Cette commande définit le contexte d’abonnement, puis récupère toutes les images du référentiel d’images.

Paramètres

-ImageName

Spécifie le nom du système d’exploitation ou de l’image de machine virtuelle dans le référentiel d’images. Si vous ne spécifiez pas ce paramètre, toutes les images sont retournées.

Type:String
Position:0
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters: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
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

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