Set-AzureRmVMSourceImage
Spécifie l’image d’une machine virtuelle.
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.
Syntaxe
Set-AzureRmVMSourceImage
[-VM] <PSVirtualMachine>
[-PublisherName] <String>
[-Offer] <String>
[-Skus] <String>
[-Version] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMSourceImage
[-VM] <PSVirtualMachine>
[-Id] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureRmVMSourceImage spécifie l’image de plateforme à utiliser pour une machine virtuelle.
Exemples
Exemple 1 : Définir des valeurs pour une image
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> Set-AzureRmVMSourceImage -VM $VirtualMachine -PublisherName "MicrosoftWindowsServer" -Offer "WindowsServer" -Skus "2012-R2-Datacenter" -Version "latest"
La première commande obtient le groupe à haute disponibilité nommé AvailablitySet03 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 attribue 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-AzureRmVMImagePublisher, Get-AzureRmVMImageOffer, Get-AzureRmVMImageSku et Get-AzureRmVMImage peuvent découvrir ces paramètres.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Id
Spécifie l’ID.
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 |
-Offer
Spécifie le type d’offre VMImage. Pour obtenir une offre d’image, utilisez l’applet de commande Get-AzureRmVMImageOffer.
Type: | String |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PublisherName
Spécifie le nom d’un éditeur d’un VMImage. Pour obtenir un éditeur, utilisez l’applet de commande Get-AzureRmVMImagePublisher.
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 |
-Skus
Spécifie une référence SKU VMImage. Pour obtenir des références SKU, utilisez l’applet de commande Get-AzureRmVMImageSku.
Type: | String |
Position: | 3 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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.
Type: | String |
Position: | 4 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VM
Spécifie l’objet de machine virtuelle locale à configurer.
Type: | PSVirtualMachine |
Alias: | VMProfile |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |