Delen via


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.

Default value: False
--export-as-snapshot

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

Default value: False
--parallel-degree

Aantal parallelle kopieerbewerkingen.

Default value: -1
--source-type

Installatiekopieën of vm's.

Geaccepteerde waarden: image, vm
Default value: 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.

Default value: 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.

Default value: 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
Default value: 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
Default value: 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
Default value: 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
Default value: 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
Default value: 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
Default value: 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>.

Default value: []
--force-string

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

Default value: 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.

Default value: []
--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>.

Default value: []
--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
Default value: 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'.

Default value: 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.

Default value: False
--exists

Wacht tot de resource bestaat.

Default value: 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.

Default value: 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.

Default value: 3600
--updated

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

Default value: 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
Default value: 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.