az image

Notitie

Deze opdrachtgroep bevat opdrachten die zijn gedefinieerd in zowel Azure CLI als ten minste één extensie. Installeer elke extensie om te profiteren van de uitgebreide mogelijkheden. Meer informatie over extensies.

Aangepaste installatiekopieën van virtuele machines beheren.

Opdracht

Name	Description	Type	Status
az image builder	Sjablonen voor de opbouwfunctie voor installatiekopieën beheren en bouwen.	Basis	GA
az image builder cancel	Annuleer de langlopende build van de installatiekopieën op basis van de installatiekopieënsjabloon.	Basis	GA
az image builder create	Maak een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer	Aangepaste sjabloonaanpassers voor installatiekopieën beheren.	Basis	GA
az image builder customizer add	Voeg een opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer clear	Verwijder alle aanpassers van de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer remove	Een opbouwfunctie voor afbeeldingen verwijderen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder delete	Sjabloon voor het maken van installatiekopieën verwijderen.	Basis	GA
az image builder error-handler	Fouthandler voor afbeeldingsbouwersjabloon beheren.	Basis	GA
az image builder error-handler add	Voeg een fouthandler toe aan een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder error-handler remove	Verwijder de fouthandler uit een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder error-handler show	Fouthandler van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder identity	Identiteiten van een sjabloon voor de opbouwfunctie voor afbeeldingen beheren.	Basis	GA
az image builder identity assign	Beheerde identiteiten toevoegen aan een bestaande sjabloon voor het maken van afbeeldingen. Op dit moment wordt slechts één gebruikersidentiteit ondersteund.	Basis	GA
az image builder identity remove	Beheerde identiteiten verwijderen uit een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder identity show	Beheerde identiteiten van een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder list	Sjablonen voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder optimizer	Sjabloonoptimalisatie voor installatiekopieën beheren.	Basis	GA
az image builder optimizer add	Een optimizer toevoegen aan een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder optimizer remove	Optimizer verwijderen uit een bestaande sjabloon voor het maken van afbeeldingen.	Basis	GA
az image builder optimizer show	De optimalisatie van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder optimizer update	Een optimizer bijwerken op basis van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output	Manage image builder template output distributors.	Basis	GA
az image builder output add	Voeg een uitvoerverdeler voor de opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output clear	Verwijder alle uitvoerdistributeurs van afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output remove	Verwijder een uitvoerdistributeur voor de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output versioning	Uitvoerversie van image builder-sjabloon beheren.	Basis	GA
az image builder output versioning remove	Verwijder alle versiebeheeropties voor opgegeven uitvoer.	Basis	GA
az image builder output versioning set	Stel de uitvoerversie van de opbouwfunctie voor installatiekopieën in van een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output versioning show	Versiebeheeropties weergeven voor opgegeven uitvoer.	Basis	GA
az image builder run	Bouw een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder show	Een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder show-runs	Uitvoer van een afbeeldingsbouwersjabloon weergeven.	Basis	GA
az image builder trigger	Sjabloontrigger voor installatiekopieën beheren.	Basis	GA
az image builder trigger create	Maak een trigger voor de opgegeven sjabloon voor de installatiekopieën van de virtuele machine.	Basis	GA
az image builder trigger delete	Verwijder een trigger voor de opgegeven sjabloon voor de installatiekopieën van de virtuele machine.	Basis	GA
az image builder trigger list	Geef alle triggers weer voor de opgegeven resource voor de afbeeldingssjabloon.	Basis	GA
az image builder trigger show	Haal de opgegeven trigger op voor de opgegeven resource van de afbeeldingssjabloon.	Basis	GA
az image builder trigger wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.	Basis	GA
az image builder update	Een sjabloon voor de opbouwfunctie voor afbeeldingen bijwerken.	Basis	GA
az image builder validator	Manage image builder template validate.	Basis	GA
az image builder validator add	Valideer een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder validator remove	Verwijder valideren uit een bestaande sjabloon voor de opbouwfunctie voor installatiekopieën.	Basis	GA
az image builder validator show	Valideer de validatie van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de sjabloon is voldaan.	Basis	GA
az image copy	Kopieer een beheerde installatiekopie (of vm) naar andere regio's. Hiervoor moet de bronschijf beschikbaar zijn.	Toestel	GA
az image create	Maak een aangepaste installatiekopie van een virtuele machine op basis van beheerde schijven of momentopnamen.	Basis	GA
az image delete	Een afbeelding verwijderen.	Basis	GA
az image list	De lijst met installatiekopieën onder een resourcegroep weergeven.	Basis	GA
az image show	Een afbeelding ophalen.	Basis	GA
az image update	Aangepaste VM-installatiekopieën bijwerken.	Basis	GA
az image wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.	Basis	GA

az image copy

Kopieer een beheerde installatiekopie (of vm) naar andere regio's. Hiervoor moet de bronschijf beschikbaar zijn.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Voorbeelden

Kopieer een afbeelding naar verschillende regio's en schoon aan het einde op.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Gebruik een al gegeneraliseerde vm om installatiekopieën in andere regio's te maken.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Vereiste parameters

--source-object-name

De naam van de installatiekopieën of VM-resource.

--source-resource-group

Naam van de resourcegroep van de bronresource.

--target-location

Door ruimte gescheiden locatielijst om de installatiekopieën in te maken (bijvoorbeeld westeurope, enzovoort).

--target-resource-group

Naam van de resourcegroep waarin u installatiekopieën wilt maken.

Optionele parameters

--cleanup

Neem deze schakeloptie op om na voltooiing tijdelijke resources te verwijderen.

standaardwaarde: False

--export-as-snapshot

Neem deze schakeloptie op om de kopieën als momentopnamen te exporteren in plaats van afbeeldingen.

standaardwaarde: False

--parallel-degree

Aantal parallelle kopieerbewerkingen.

standaardwaarde: -1

--source-type

Installatiekopieën of vm's.

geaccepteerde waarden: image, vm

standaardwaarde: image

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--target-name

Naam van de uiteindelijke installatiekopieën die worden gemaakt.

--target-subscription

Naam of id van het abonnement waarin de uiteindelijke installatiekopieën moeten worden gemaakt.

--temporary-resource-group-name

De naam van de resourcegroep waarin een tijdelijk opslagaccount wordt gemaakt.

standaardwaarde: image-copy-rg

--timeout

Tijd in seconden voordat de kopieerbewerking is voltooid. Verhoog deze tijd als u grote installatiekopieën (schijven) wilt kopiëren, zoals 512 GB of meer.

standaardwaarde: 3600

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image create

Maak een aangepaste installatiekopie van een virtuele machine op basis van beheerde schijven of momentopnamen.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Voorbeelden

Maak een installatiekopieën van een bestaande schijf.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Maak een installatiekopieën door een bestaande gegeneraliseerde virtuele machine in dezelfde resourcegroep vast te leggen.

az image create -g MyResourceGroup -n image1 --source MyVm1

Vereiste parameters

--name -n

Nieuwe installatiekopieënnaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--source

Besturingssysteemschijfbron uit dezelfde regio, met inbegrip van een id of naam van een virtuele machine, blob-URI van besturingssysteemschijf, id van beheerde besturingssysteemschijf of -naam, of id of naam van de momentopname van het besturingssysteem.

Optionele parameters

--data-disk-caching

Cachetype voor opslag voor de gegevensschijf van de installatiekopie.

geaccepteerde waarden: None, ReadOnly, ReadWrite

--data-disk-sources

Door ruimte gescheiden lijst met gegevensschijfbronnen, waaronder niet-beheerde blob-URI, beheerde schijf-id of naam, of momentopname-id of naam.

--edge-zone

De naam van de randzone.

--hyper-v-generation

De hypervisorgeneratie van de virtuele machine die is gemaakt op basis van de installatiekopieën.

geaccepteerde waarden: V1, V2

standaardwaarde: V1

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--os-disk-caching

Opslagcachetype voor de besturingssysteemschijf van de installatiekopie.

geaccepteerde waarden: None, ReadOnly, ReadWrite

--os-type

geaccepteerde waarden: Linux, Windows

--storage-sku

De SKU van het opslagaccount waarmee de VM-installatiekopieën moeten worden gemaakt. Niet gebruikt als de bron-VM is opgegeven.

geaccepteerde waarden: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--zone-resilient

Hiermee geeft u op of een installatiekopieën zonebestendig zijn of niet. Standaard ingesteld op onwaar. Zonetolerante installatiekopieën kunnen alleen worden gemaakt in regio's die zone-redundante opslag bieden.

geaccepteerde waarden: false, true

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image delete

Een afbeelding verwijderen.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--image-name --name -n

De naam van de afbeelding.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image list

De lijst met installatiekopieën onder een resourcegroep weergeven.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Optionele parameters

--max-items

Totaal aantal items dat moet worden geretourneerd in de uitvoer van de opdracht. Als het totale aantal beschikbare items groter is dan de opgegeven waarde, wordt een token opgegeven in de uitvoer van de opdracht. Als u paginering wilt hervatten, geeft u de tokenwaarde op in --next-token het argument van een volgende opdracht.

--next-token

Token om op te geven waar paginering moet worden gestart. Dit is de tokenwaarde van een eerder afgekapt antwoord.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image show

Een afbeelding ophalen.

az image show [--expand]
              [--ids]
              [--image-name]
              [--resource-group]
              [--subscription]

Optionele parameters

--expand

De uitvouwexpressie die moet worden toegepast op de bewerking.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--image-name --name -n

De naam van de afbeelding.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image update

Aangepaste VM-installatiekopieën bijwerken.

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

Voorbeelden

Tags toevoegen of bijwerken.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Verwijder alle tags.

az image update -n ImageName -g resourceGroup --tags

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

standaardwaarde: []

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

standaardwaarde: False

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeelding. Vereist.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

standaardwaarde: []

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

standaardwaarde: []

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.

az image wait [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--expand]
              [--ids]
              [--image-name]
              [--interval]
              [--resource-group]
              [--subscription]
              [--timeout]
              [--updated]

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

standaardwaarde: False

--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

standaardwaarde: False

--exists

Wacht tot de resource bestaat.

standaardwaarde: False

--expand

De uitvouwexpressie die moet worden toegepast op de bewerking.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--image-name --name -n

De naam van de afbeelding.

--interval

Polling-interval in seconden.

standaardwaarde: 30

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600

--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

standaardwaarde: False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.