az sig image-version
Nota
Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.
Gestire la versione dell'immagine della raccolta condivisa con la macchina virtuale.
Comandi
Nome | Descrizione | Tipo | Stato |
---|---|---|---|
az sig image-version create |
Creare una nuova versione dell'immagine. |
Memoria centrale | Disponibilità generale |
az sig image-version delete |
Eliminare una versione dell'immagine della raccolta. |
Memoria centrale | Disponibilità generale |
az sig image-version list |
Elencare le versioni delle immagini della raccolta in una definizione di immagine della raccolta. |
Memoria centrale | Disponibilità generale |
az sig image-version list-community |
Elencare le versioni delle immagini delle macchine virtuali in una community della raccolta. |
Memoria centrale | Disponibilità generale |
az sig image-version list-community (image-gallery estensione) |
Elencare le versioni delle immagini delle macchine virtuali in una community della raccolta (anteprima). |
Estensione | Sperimentale |
az sig image-version list-shared |
Elencare le versioni delle immagini della macchina virtuale in una raccolta condivisa direttamente nella sottoscrizione o nel tenant. |
Memoria centrale | Disponibilità generale |
az sig image-version show |
Recupera informazioni su una versione dell'immagine della raccolta. |
Memoria centrale | Disponibilità generale |
az sig image-version show-community |
Ottenere una versione dell'immagine della raccolta della community. |
Memoria centrale | Disponibilità generale |
az sig image-version show-community (image-gallery estensione) |
Ottenere una versione dell'immagine in una community della raccolta (anteprima). |
Estensione | Sperimentale |
az sig image-version show-shared |
Ottenere una versione dell'immagine in una raccolta condivisa direttamente nella sottoscrizione o nel tenant. |
Memoria centrale | Disponibilità generale |
az sig image-version undelete |
Ripristinare la versione dell'immagine eliminata temporanea. |
Memoria centrale | Anteprima |
az sig image-version update |
Aggiornare una versione dell'immagine di condivisione. |
Memoria centrale | Disponibilità generale |
az sig image-version wait |
Attendere l'operazione correlata alla versione dell'immagine. |
Memoria centrale | Disponibilità generale |
az sig image-version create
Creare una nuova versione dell'immagine.
Questa operazione potrebbe richiedere molto tempo a seconda del numero di area di replica. È consigliabile usare "--no-wait".
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--data-snapshot-luns]
[--data-snapshots]
[--data-vhds-luns]
[--data-vhds-sa]
[--data-vhds-uris]
[--end-of-life-date]
[--exclude-from-latest {false, true}]
[--image-version]
[--location]
[--managed-image]
[--no-wait]
[--os-snapshot]
[--os-vhd-storage-account]
[--os-vhd-uri]
[--replica-count]
[--replication-mode {Full, Shallow}]
[--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
[--tags]
[--target-edge-zone-encryption]
[--target-edge-zones]
[--target-region-cvm-encryption]
[--target-region-encryption]
[--target-regions]
[--virtual-machine]
Esempio
Aggiungere una nuova versione dell'immagine da una macchina virtuale
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM
Aggiungere una nuova versione dell'immagine da un'immagine gestita
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage
Aggiungere una nuova versione dell'immagine da un'altra versione dell'immagine
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0
Aggiungere una nuova versione dell'immagine da un disco gestito
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk
Aggiungere una nuova versione dell'immagine da un disco gestito e aggiungere altri dischi dati
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0
Aggiungere una nuova versione dell'immagine da uno snapshot di un disco del sistema operativo.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot
Aggiungere una nuova versione dell'immagine da uno snapshot di un disco del sistema operativo e aggiungere altri snapshot come dischi dati
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0
Aggiungere una nuova versione dell'immagine da un disco rigido virtuale di un disco del sistema operativo.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file
Aggiungere una nuova versione dell'immagine da un disco rigido virtuale di un disco del sistema operativo e aggiungere altri dischi rigidi virtuali come dischi dati
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0
È possibile combinare snapshot, dischi gestiti e dischi rigidi virtuali per creare una nuova versione dell'immagine. Aggiungere una nuova versione dell'immagine usando un disco rigido virtuale come disco del sistema operativo e un disco gestito e uno snapshot come dischi dati.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1
Aggiungere una nuova versione dell'immagine e copiarla in altre aree. La posizione iniziale per l'origine della versione dell'immagine deve essere inclusa nell'elenco delle aree di destinazione. Per ogni area aggiuntiva, è possibile specificare un numero di repliche e un tipo di account di archiviazione diversi. In caso contrario, l'area erediterà dall'oggetto globale. Il numero di repliche predefinito è 1 e il tipo di account di archiviazione predefinito è LRS Standard. In questo esempio eastus2 avrà una replica archiviata nell'archiviazione ZRS Standard, ukwest avrà 3 repliche archiviate nell'archiviazione con ridondanza della zona standard, southindia avrà una replica archiviata nell'archiviazione LRS Standard e brasilesouth avrà 2 repliche archiviate nell'archiviazione con ridondanza locale Standard.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs
Aggiungere una nuova versione dell'immagine con crittografia usando un set di crittografia del disco. La crittografia viene applicata a ogni disco che fa parte della versione dell'immagine.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2
Aggiungere una nuova versione dell'immagine e copiarla in posizioni estese.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs
Aggiungere una nuova versione dell'immagine e copiarla in percorsi estesi con la crittografia usando un set di crittografia del disco.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2
Aggiungere una nuova versione dell'immagine e non attendere. In seguito è possibile richiamare il comando "az sig image-version wait" quando si è pronti per creare una macchina virtuale dalla versione dell'immagine della raccolta
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait
Aggiungere una nuova versione dell'immagine, ma rimuoverla dalla considerazione come versione più recente nella definizione dell'immagine
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true
Aggiungere una nuova versione dell'immagine e impostarne la data di fine vita. La versione dell'immagine può comunque essere usata per creare una macchina virtuale dopo la data di fine del ciclo di vita.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00
Parametri necessari
Definizione dell'immagine della raccolta.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Indicare se è consentita o meno la rimozione della versione dell'immagine della raccolta dalle aree replicate.
Numeri di unità logica (delimitati da spazi) di snapshot del disco dati.
Nomi o ID (delimitati da spazi) di snapshot del disco dati.
Numeri di unità logica (delimitati da spazi) degli URI del disco rigido virtuale di origine dei dischi dati.
Nomi o ID (delimitati da spazi) degli account di archiviazione degli URI del disco rigido virtuale di origine dei dischi dati.
URI del disco rigido virtuale di origine (delimitati da spazi) di dischi dati.
Data di fine vita, ad esempio "2020-12-31".
Il flag indica che se è impostato su true, gli utenti che distribuiscono macchine virtuali con versione omessa non useranno questa versione.
ID risorsa dell'origine della versione dell'immagine della raccolta.
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Nome immagine (se nello stesso gruppo di risorse) o ID risorsa.
Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.
Nome o ID dello snapshot del disco del sistema operativo.
Nome o ID dell'account di archiviazione dell'URI del disco rigido virtuale di origine del disco del sistema operativo.
URI del disco rigido virtuale di origine del sistema operativo.
Numero predefinito di repliche da creare per area. Per impostare i conteggi delle repliche a livello di area, usare --target-regions.
Parametro facoltativo che specifica la modalità da usare per la replica. Questa proprietà non è aggiornabile.
Tipo di account di archiviazione predefinito da usare per area. Per impostare i tipi di account di archiviazione a livello di area, usare --target-regions.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Elenco separato da spazi delle chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta per ogni area. Formato per ogni zona perimetrale: , os_des<>,< lun1_des>,< lun2_des>.
Elenco delimitato da spazi di aree, zone perimetrali, conteggi delle repliche e tipi di archiviazione. Usare =[=][=] per impostare facoltativamente il numero di repliche e/o il tipo di account di archiviazione per ogni area. Se non viene specificato un numero di repliche, verrà usato il numero di repliche predefinito. Se non viene specificato un tipo di account di archiviazione, verrà usato il tipo di account di archiviazione predefinito. Se si specifica "--target-edge-zones Nessuno", le posizioni estese di destinazione verranno cancellate.
Elenco separato da spazi della chiave gestita dal cliente per La macchina virtuale riservata che crittografa il disco del sistema operativo nell'artefatto della raccolta per ogni area. Formato per ogni area: <os_cvm_encryption_type>,<os_cvm_des>
. I valori validi per os_cvm_encryption_type sono EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.
Elenco separato da spazi delle chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta per ogni area. Formato per ogni area: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>
. Usare "null" come segnaposto.
Elenco delimitato da spazi di aree e conteggi delle repliche. Usare <region>[=<replica count>][=<storage account type>]
per impostare facoltativamente il numero di repliche e/o il tipo di account di archiviazione per ogni area. Se non viene specificato un numero di repliche, verrà usato il numero di repliche predefinito. Se non viene specificato un tipo di account di archiviazione, verrà usato il tipo di account di archiviazione predefinito.
ID risorsa dell'origine della macchina virtuale.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version delete
Eliminare una versione dell'immagine della raccolta.
az sig image-version delete [--gallery-image-definition]
[--gallery-image-version]
[--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Parametri facoltativi
Nome della definizione dell'immagine della raccolta in cui risiede la versione dell'immagine.
Nome della versione dell'immagine della raccolta da eliminare.
Nome del Raccolta immagini condivise in cui risiede la definizione dell'immagine.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version list
Elencare le versioni delle immagini della raccolta in una definizione di immagine della raccolta.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]
Parametri necessari
Definizione dell'immagine della raccolta.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token
di un comando successivo.
Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version list-community
Elencare le versioni delle immagini delle macchine virtuali in una community della raccolta.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]
Esempio
Elencare le versioni di un'immagine in una community della raccolta.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation
Parametri facoltativi
Nome della definizione dell'immagine della raccolta community da cui devono essere elencate le versioni dell'immagine.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Valore stringa che identifica la parte dell'elenco di contenitori da restituire con l'operazione di elenco successiva. L'operazione restituisce il valore NextMarker all'interno del corpo della risposta se l'operazione di elenco non ha restituito tutti i contenitori rimanenti da elencare con la pagina corrente. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.
Nome pubblico della raccolta community.
Mostra nextMarker nel risultato quando specificato.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version list-community (image-gallery estensione)
Questo comando è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Elencare le versioni delle immagini delle macchine virtuali in una community della raccolta (anteprima).
Elencare le versioni delle immagini delle macchine virtuali in una community della raccolta (funzionalità di anteprima privata, contattare il team della raccolta immagini della community tramite posta elettronica sigpmdev@microsoft.com per registrarsi per l'anteprima se si è interessati a usare questa funzionalità).
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]
Esempio
Elencare le versioni di un'immagine in una community della raccolta.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation
Parametri facoltativi
Nome della definizione dell'immagine della raccolta community da cui devono essere elencate le versioni dell'immagine.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Valore stringa che identifica la parte dell'elenco di contenitori da restituire con l'operazione di elenco successiva. L'operazione restituisce il valore NextMarker all'interno del corpo della risposta se l'operazione di elenco non ha restituito tutti i contenitori rimanenti da elencare con la pagina corrente. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.
Nome pubblico della raccolta community.
Mostra nextMarker nel risultato quando specificato.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version list-shared
Elencare le versioni delle immagini della macchina virtuale in una raccolta condivisa direttamente nella sottoscrizione o nel tenant.
az sig image-version list-shared [--gallery-image-definition]
[--gallery-unique-name]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]
Esempio
Elencare le versioni delle immagini in una raccolta condivisa direttamente nella sottoscrizione nella posizione e nella definizione di immagine specificati.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation
Elencare le versioni delle immagini in una raccolta condivisa direttamente al tenant nella posizione e nella definizione di immagine specificati.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenant
Parametri facoltativi
Nome della definizione dell'immagine della raccolta condivisa da cui devono essere elencate le versioni delle immagini.
Nome univoco della raccolta condivisa.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Valore stringa che identifica la parte dell'elenco di contenitori da restituire con l'operazione di elenco successiva. L'operazione restituisce il valore NextMarker all'interno del corpo della risposta se l'operazione di elenco non ha restituito tutti i contenitori rimanenti da elencare con la pagina corrente. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.
Parametro di query per decidere quali raccolte condivise recuperare durante l'esecuzione di operazioni di presentazione. Se non specificato, elencare in base all'ID sottoscrizione.
Mostra nextMarker nel risultato quando specificato.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version show
Recupera informazioni su una versione dell'immagine della raccolta.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]
Parametri necessari
Definizione dell'immagine della raccolta.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Espressione di espansione da applicare all'operazione, ad esempio 'ReplicationStatus'.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version show-community
Ottenere una versione dell'immagine della raccolta della community.
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]
Parametri facoltativi
Nome della definizione dell'immagine della raccolta community da cui devono essere elencate le versioni dell'immagine.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Nome pubblico della raccolta della community.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version show-community (image-gallery estensione)
Questo comando è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Ottenere una versione dell'immagine in una community della raccolta (anteprima).
Ottenere una versione dell'immagine in una community della raccolta (funzionalità di anteprima privata, contattare il team della raccolta immagini della community tramite posta elettronica sigpmdev@microsoft.com per registrarsi per l'anteprima se si è interessati a usare questa funzionalità).
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]
Esempio
Ottenere una versione dell'immagine in una community della raccolta nella posizione specificata.
az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation
Parametri facoltativi
Nome della definizione dell'immagine della raccolta community da cui devono essere elencate le versioni dell'immagine.
Nome della versione dell'immagine della raccolta da creare. Deve seguire il modello di nome della versione semantica: i caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit. Formato:...
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Nome pubblico della raccolta community.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version show-shared
Ottenere una versione dell'immagine in una raccolta condivisa direttamente nella sottoscrizione o nel tenant.
az sig image-version show-shared [--gallery-image-definition]
[--gallery-image-version]
[--gallery-unique-name]
[--ids]
[--location]
[--subscription]
Esempio
Ottenere una versione dell'immagine in una raccolta condivisa direttamente nella sottoscrizione o nel tenant nella posizione specificata.
az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation
Parametri facoltativi
Nome della definizione dell'immagine della raccolta condivisa da cui devono essere elencate le versioni delle immagini.
Nome della versione dell'immagine della raccolta da creare. Deve seguire il modello di nome della versione semantica: i caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit. Formato:...
Nome univoco della raccolta condivisa.
Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version undelete
Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Ripristinare la versione dell'immagine eliminata temporanea.
L'operazione avrà esito positivo solo se viene usata all'interno di una raccolta con eliminazione temporanea.
az sig image-version undelete --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--location]
[--no-wait]
[--tags]
Esempio
Ripristinare una versione dell'immagine eliminata temporanea
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1
Parametri necessari
Definizione dell'immagine della raccolta.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Indicare se è consentita o meno la rimozione della versione dell'immagine della raccolta dalle aree replicate.
Posizione. Usare i valori ottenuti con az account list-locations
. È possibile configurare la posizione predefinito con az configure --defaults location=<location>
.
Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version update
Aggiornare una versione dell'immagine di condivisione.
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--add]
[--allow-replicated-location-deletion {false, true}]
[--force-string]
[--no-wait]
[--remove]
[--replica-count]
[--set]
[--target-edge-zones]
[--target-regions]
Esempio
Modificare le aree di replica e il numero di repliche
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2
Modificare i percorsi estesi della replica
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1
Cancellare le posizioni estese della replica
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None
Eseguire la replica in un'area aggiuntiva. Facoltativo, è possibile impostare il numero di repliche per l'area ed escludere questa immagine quando si usa la versione più recente della definizione dell'immagine.
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=true
Modificare se un'immagine deve essere inclusa in considerazione per la versione più recente nella definizione dell'immagine. L'impostazione di questo valore su true esclude l'immagine dalla considerazione e impostando questo valore su false include l'immagine da considerare.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true
Modificare la data di fine vita per una versione dell'immagine. L'immagine può comunque essere usata per creare macchine virtuali dopo la fine della data di vita.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00
Consenti di rimuovere la versione dell'immagine della raccolta dalle aree replicate.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true
Parametri necessari
Definizione dell'immagine della raccolta.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>
.
Indicare se è consentita o meno la rimozione della versione dell'immagine della raccolta dalle aree replicate.
Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.
Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.
Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Numero predefinito di repliche da creare per area. Per impostare i conteggi delle repliche a livello di area, usare --target-regions.
Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>
.
Elenco delimitato da spazi di aree, zone perimetrali, conteggi delle repliche e tipi di archiviazione. Usare =[=][=] per impostare facoltativamente il numero di repliche e/o il tipo di account di archiviazione per ogni area. Se non viene specificato un numero di repliche, verrà usato il numero di repliche predefinito. Se non viene specificato un tipo di account di archiviazione, verrà usato il tipo di account di archiviazione predefinito. Se si specifica "--target-edge-zones Nessuno", le posizioni estese di destinazione verranno cancellate.
Elenco delimitato da spazi di aree e conteggi delle repliche. Usare <region>[=<replica count>][=<storage account type>]
per impostare facoltativamente il numero di repliche e/o il tipo di account di archiviazione per ogni area. Se non viene specificato un numero di repliche, verrà usato il numero di repliche predefinito. Se non viene specificato un tipo di account di archiviazione, verrà usato il tipo di account di archiviazione predefinito.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az sig image-version wait
Attendere l'operazione correlata alla versione dell'immagine.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]
Esempio
attendere che venga aggiornata una versione dell'immagine
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
attendere l'operazione correlata alla versione dell'immagine. (generato automaticamente)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
Parametri necessari
Definizione dell'immagine della raccolta.
Versione dell'immagine della raccolta nel modello di versione semantica. I caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit, ad esempio <MajorVersion>.<MinorVersion>.<Patch>
.
Nome della raccolta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri facoltativi
Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.
Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Attendere l'eliminazione.
Attendere che la risorsa esista.
Espressione di espansione da applicare all'operazione. Il valore predefinito 'ReplicationStatus' è Nessuno.
Intervallo di polling in secondi.
Attesa massima in secondi.
Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.