Update-AzureVMImage
Aggiorna l'etichetta di un'immagine del sistema operativo nel repository di immagini.
Nota
I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.
Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.
Sintassi
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>]
Descrizione
Il cmdlet Update-AzureVMImage aggiorna l'etichetta in un'immagine del sistema operativo nel repository di immagini. Restituisce un oggetto immagine con informazioni sull'immagine aggiornata.
Esempio
Esempio 1: Aggiornare un'immagine modificando l'etichetta dell'immagine
PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"
Questo comando aggiorna l'immagine denominata Windows-Server-2008-SP2 modificando l'etichetta dell'immagine in DoNotUse.
Esempio 2: Ottenere tutti i sistemi operativi in base all'etichetta e quindi aggiornare l'etichetta
PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"
Questo comando ottiene tutte le immagini del sistema operativo con etichetta DoNotUse e modifica l'etichetta in Aggiornato.
Parametri
-Description
Specifica la descrizione dell'immagine del sistema operativo.
Tipo: | String |
Posizione: | 3 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-DiskConfig
Specifica la configurazione del disco del sistema operativo e del disco dati per l'immagine della macchina virtuale creata usando i cmdlet New-AzureVMImageDiskConfigSet, Set-AzureVMImageOSDiskConfig e Set-AzureVMImageDataDiskConfig .
Tipo: | VirtualMachineImageDiskConfigSet |
Posizione: | 8 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-DontShowInGui
Indica che questo cmdlet non mostra l'immagine nell'interfaccia utente grafica.
Tipo: | SwitchParameter |
Posizione: | 12 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Eula
Specifica il contratto di licenza con l'utente finale. È consigliabile che il valore sia un URL.
Tipo: | String |
Posizione: | 2 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-IconName
Specifica il nome dell'icona standard per il sistema operativo o l'immagine della macchina virtuale.
Tipo: | String |
Alias: | IconUri |
Posizione: | 10 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ImageFamily
Specifica un valore che può essere usato per raggruppare le immagini del sistema operativo o della macchina virtuale.
Tipo: | String |
Posizione: | 4 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ImageName
Specifica il nome dell'immagine da aggiornare nel repository di immagini.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-InformationAction
Specifica la modalità di risposta di questo cmdlet a un evento informativo.
I valori validi per questo parametro sono:
- Continua
- Ignora
- Inquire
- SilentlyContinue
- Arresta
- Sospendi
Tipo: | ActionPreference |
Alias: | infa |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-InformationVariable
Specifica una variabile di informazioni.
Tipo: | String |
Alias: | iv |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Label
Specifica la nuova etichetta dell'immagine.
Tipo: | String |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Language
Specifica la lingua per il sistema operativo nella macchina virtuale o nell'immagine del sistema operativo.
Tipo: | String |
Posizione: | 9 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-PrivacyUri
Specifica l'URI che punta a un documento contenente l'informativa sulla privacy correlata all'immagine del sistema operativo.
Tipo: | Uri |
Posizione: | 6 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Profile
Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.
Tipo: | AzureSMProfile |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PublishedDate
Specifica la data in cui l'immagine del sistema operativo è stata aggiunta al repository di immagini.
Tipo: | DateTime |
Posizione: | 5 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-RecommendedVMSize
Specifica le dimensioni della macchina virtuale.
I valori validi per questo parametro sono:
- Medio
- Grande
- Molto grande
- A5
- A6
- A7
Tipo: | String |
Posizione: | 7 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-SmallIconName
Specifica il nome dell'icona piccola per il sistema operativo o l'immagine della macchina virtuale.
Tipo: | String |
Alias: | SmallIconUri |
Posizione: | 11 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
Output
OSImageContext