Partager via


Set-AzVMSourceImage

Spécifie l’image d’une machine virtuelle.

Syntaxe

ImageReferenceSkuParameterSet (Par défaut)

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-PublisherName] <String>
    [-Offer] <String>
    [-Skus] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ImageReferenceIdParameterSet

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-Id] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

L’applet de commande Set-AzVMSourceImage spécifie l’image de plateforme à utiliser pour une machine virtuelle.

Exemples

Exemple 1 : Définir des valeurs pour une image

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "MicrosoftWindowsServer" -Offer "WindowsServer" -Skus "2012-R2-Datacenter" -Version "latest"

La première commande obtient le groupe à haute disponibilité nommé AvailabilitySet03 dans le groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $AvailabilitySet. La deuxième commande crée un objet de machine virtuelle, puis la stocke dans la variable $VirtualMachine. La commande affecte un nom et une taille à la machine virtuelle. La machine virtuelle appartient au groupe à haute disponibilité stocké dans $AvailabilitySet. La commande finale définit les valeurs pour le nom de l’éditeur, l’offre, la référence SKU et la version. Les applets de commande Get-AzVMImagePublisher, Get-AzVMImageOffer, Get-AzVMImageSku et Get-AzVMImage peuvent découvrir ces paramètres.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

Spécifie l’ID.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ImageReferenceIdParameterSet
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Offer

Spécifie le type d’offre VMImage. Pour obtenir une offre d’image, utilisez l’applet de commande Get-AzVMImageOffer.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ImageReferenceSkuParameterSet
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PublisherName

Spécifie le nom d’un éditeur d’un VMImage. Pour obtenir un éditeur, utilisez l’applet de commande Get-AzVMImagePublisher.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ImageReferenceSkuParameterSet
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Skus

Spécifie une référence SKU VMImage. Pour obtenir des références SKU, utilisez l’applet de commande Get-AzVMImageSku.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ImageReferenceSkuParameterSet
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Version

Spécifie une version d’un VMImage. Pour utiliser la dernière version, spécifiez une valeur de dernière version au lieu d’une version particulière.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ImageReferenceSkuParameterSet
Position:4
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-VM

Spécifie l’objet de machine virtuelle locale à configurer.

Propriétés du paramètre

Type:PSVirtualMachine
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:VMProfile

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSVirtualMachine

String

Sorties

PSVirtualMachine