Update-AzureVMImage
Met à jour l’étiquette d’une image de système d’exploitation dans le 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
Update-AzureVMImage
[-ImageName] <String>
[-Label] <String>
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
[[-Language] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-DontShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
L’applet de commande Update-AzureVMImage met à jour l’étiquette sur une image du système d’exploitation dans le référentiel d’images. Elle retourne un objet image avec des informations sur l’image mise à jour.
Exemples
Exemple 1 : Mettre à jour une image en modifiant l’étiquette d’image
PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"Cette commande met à jour l’image nommée Windows-Server-2008-SP2 en modifiant l’étiquette d’image en DoNotUse.
Exemple 2 : Obtenir tous les systèmes d’exploitation par étiquette, puis mettre à jour l’étiquette
PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"Cette commande obtient toutes les images du système d’exploitation étiquetées DoNotUse et remplace l’étiquette par Mise à jour.
Paramètres
-Description
Spécifie la description de l’image du système d’exploitation.
| Type: | String |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DiskConfig
Spécifie la configuration du disque du système d’exploitation et du disque de données pour l’image de machine virtuelle créée à l’aide des applets de commande New-AzureVMImageDiskConfig, Set-AzureVMImageOSDiskConfig et Set-AzureVMImageDataDiskConfig .
| Type: | VirtualMachineImageDiskConfigSet |
| Position: | 8 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DontShowInGui
Indique que cette applet de commande n’affiche pas l’image dans l’interface utilisateur graphique.
| Type: | SwitchParameter |
| Position: | 12 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Eula
Spécifie le contrat de licence utilisateur final. Nous recommandons que la valeur soit une URL.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-IconName
Spécifie le nom de l’icône standard pour le système d’exploitation ou l’image de machine virtuelle.
| Type: | String |
| Alias: | IconUri |
| Position: | 10 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ImageFamily
Spécifie une valeur qui peut être utilisée pour regrouper des images de système d’exploitation ou de machine virtuelle.
| 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 |
-ImageName
Spécifie le nom de l’image à mettre à jour dans le 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 |
-Label
Spécifie la nouvelle étiquette de l’image.
| 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 |
-Language
Spécifie la langue du système d’exploitation sur la machine virtuelle ou l’image du système d’exploitation.
| Type: | String |
| Position: | 9 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PrivacyUri
Spécifie l’URI qui pointe vers un document qui contient la stratégie de confidentialité liée à l’image du système d’exploitation.
| Type: | Uri |
| Position: | 6 |
| 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 |
-PublishedDate
Spécifie la date à laquelle l’image du système d’exploitation a été ajoutée au référentiel d’images.
| Type: | DateTime |
| Position: | 5 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-RecommendedVMSize
Spécifie la taille de la machine virtuelle.
Les valeurs valides pour ce paramètre sont :
- Moyenne
- grand
- Très grande
- A5
- A6
- A7
| Type: | String |
| Position: | 7 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-SmallIconName
Spécifie le nom de la petite icône pour le système d’exploitation ou l’image de machine virtuelle.
| Type: | String |
| Alias: | SmallIconUri |
| Position: | 11 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Sorties
OSImageContext