Delen via

az resource

  • Referentie

Azure-resources beheren.

Opdracht

Name Description Type Status
az resource create

Een resource maken.

 Basis GA
az resource delete

Een resource verwijderen.

 Basis GA
az resource invoke-action

Roep een actie aan voor de resource.

 Basis GA
az resource link

Koppelingen tussen resources beheren.

 Basis GA
az resource link create

Maak een nieuwe koppeling tussen resources.

 Basis GA
az resource link delete

Een koppeling tussen resources verwijderen.

 Basis GA
az resource link list

Resourcekoppelingen weergeven.

 Basis GA
az resource link show

Hiermee haalt u een resourcekoppeling op met de opgegeven id.

 Basis GA
az resource link update

Koppeling tussen resources bijwerken.

 Basis GA
az resource list

Hiermee vraagt u een lijst met resources op.

 Basis GA
az resource lock

Vergrendelingen op Azure-resourceniveau beheren.

 Basis GA
az resource lock create

Maak een vergrendeling op resourceniveau.

 Basis GA
az resource lock delete

Een vergrendeling op resourceniveau verwijderen.

 Basis GA
az resource lock list

Lijst met vergrendelingsgegevens op resourceniveau.

 Basis GA
az resource lock show

De details van een vergrendeling op resourceniveau weergeven.

 Basis GA
az resource lock update

Werk een vergrendeling op resourceniveau bij.

 Basis GA
az resource move

Resources van de ene resourcegroep naar de andere verplaatsen (kan onder een ander abonnement staan).

 Basis GA
az resource patch

Werk een resource bij per PATCH-aanvraag.

 Basis GA
az resource show

Haal de details van een resource op.

 Basis GA
az resource tag

Tag een resource.

 Basis GA
az resource update

Werk een resource bij op PUT-aanvraag.

 Basis GA
az resource wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een resources wordt voldaan.

 Basis GA

az resource create

Bewerken

Een resource maken.

az resource create --properties
                   [--api-version]
                   [--id]
                   [--is-full-object]
                   [--latest-include-preview]
                   [--location]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Voorbeelden

Maak een API-app door een volledige JSON-configuratie op te geven.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"location\": \
        \"West US\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Maak een resource door de JSON-configuratie van een bestand te laden.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile

Maak een web-app met de minimaal vereiste configuratiegegevens.

az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
    --properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
        {ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"

Maak een resource met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview

Een site-extensie maken voor een web-app

az resource create -g myRG --api-version "2018-02-01" \
    --name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"  \
        --resource-type Microsoft.Web/sites/siteextensions --is-full-object \
            --properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \
                \"location\": \"West US\", \"version\": \"1.9.0\" }"

Vereiste parameters

--properties -p

Een tekenreeks met JSON-indeling die resource-eigenschappen bevat.

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--id

Resource-id.

--is-full-object

Geef aan dat het eigenschappenobject andere opties bevat, zoals locatie, tags, sku en/of plan.

Default value: False
--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--location -l

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

--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource delete

Bewerken

Een resource verwijderen.

az resource delete [--api-version]
                   [--ids]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--no-wait]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Voorbeelden

Verwijder een virtuele machine met de naam 'MyVm'.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Een web-app verwijderen met behulp van een resource-id.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Een subnet verwijderen met behulp van een resource-id.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Verwijder een virtuele machine met de naam 'MyVm' met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource invoke-action

Bewerken

Roep een actie aan voor de resource.

Een lijst met mogelijke acties die betrekking hebben op een resource, vindt u op https://docs.microsoft.com/rest/api/. Alle POST-aanvragen zijn acties die kunnen worden aangeroepen en worden opgegeven aan het einde van het URI-pad. Als u bijvoorbeeld een VIRTUELE machine wilt stoppen, is https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} de aanvraag-URI en de bijbehorende actie.powerOff Dit is te vinden op https://docs.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop.

az resource invoke-action --action
                          [--api-version]
                          [--ids]
                          [--latest-include-preview]
                          [--name]
                          [--namespace]
                          [--no-wait]
                          [--parent]
                          [--request-body]
                          [--resource-group]
                          [--resource-type]

Voorbeelden

Schakel een vm uit, opgegeven door id.

az resource invoke-action --action powerOff \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}

Leg informatie vast voor een gestopte vm.

az resource invoke-action --action capture \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
    Microsoft.Compute/virtualMachines/{VMName} \
  --request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
    \"myContainer\", \"overwriteVhds\": true }"

Roep een actie aan voor de resource. (automatisch gegenereerd)

az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites

Vereiste parameters

--action

De actie die wordt aangeroepen voor de opgegeven resource.

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--request-body

Met JSON gecodeerde parameterargumenten voor de actie die wordt doorgegeven in de hoofdtekst van de postaanvraag. Gebruik @{file} om een bestand te laden.

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource list

Bewerken

Hiermee vraagt u een lijst met resources op.

az resource list [--location]
                 [--name]
                 [--namespace]
                 [--resource-group]
                 [--resource-type]
                 [--tag]

Voorbeelden

Geef alle resources in de regio VS - west weer.

az resource list --location westus

Vermeld alle resources met de naam 'resourceName'.

az resource list --name 'resourceName'

Vermeld alle resources met de tag 'test'.

az resource list --tag test

Vermeld alle resources met een tag die begint met 'test'.

az resource list --tag 'test*'

Vermeld alle resources met de tag 'test' met de waarde 'voorbeeld'.

az resource list --tag test=example

Optionele parameters

--location -l

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

--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

--tag

Eén tag in de indeling '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 resource move

Bewerken

Resources van de ene resourcegroep naar de andere verplaatsen (kan onder een ander abonnement staan).

az resource move --destination-group
                 --ids
                 [--destination-subscription-id]

Voorbeelden

Meerdere resources verplaatsen naar de doelresourcegroep onder het doelabonnement

az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"

Vereiste parameters

--destination-group

De naam van de doelresourcegroep.

--ids

De door spaties gescheiden resource-id's die moeten worden verplaatst.

Optionele parameters

--destination-subscription-id

De id van het doelabonnement.

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 resource patch

Bewerken

Werk een resource bij per PATCH-aanvraag.

Het biedt ondersteuning voor het bijwerken van resources met tekenreeks met JSON-indeling. Als de patchbewerking mislukt, voert u 'az resource update' uit.

az resource patch --properties
                  [--api-version]
                  [--ids]
                  [--is-full-object]
                  [--latest-include-preview]
                  [--name]
                  [--namespace]
                  [--parent]
                  [--resource-group]
                  [--resource-type]

Voorbeelden

Werk een web-app bij met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
  --latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"

Werk een resource bij met behulp van JSON-configuratie vanuit een bestand.

az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
  --is-full-object --properties @jsonConfigFile

Werk een API-app bij door een JSON-configuratie op te geven.

az resource patch --name MyApiApp --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Vereiste parameters

--properties -p

Een tekenreeks met JSON-indeling die resource-eigenschappen bevat.

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--is-full-object

Geef aan dat het eigenschappenobject andere opties bevat, zoals locatie, tags, sku en/of plan.

Default value: False
--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource show

Bewerken

Haal de details van een resource op.

az resource show [--api-version]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--latest-include-preview]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]

Voorbeelden

Een virtuele-machineresource met de naam 'MyVm' weergeven.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Een web-app weergeven met behulp van een resource-id.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Een subnet weergeven.

az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets

Een subnet weergeven met behulp van een resource-id.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Een padregel voor de toepassingsgateway weergeven.

az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1

Geef een virtuele-machineresource weer met de naam 'MyVm' met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--include-response-body

Gebruik deze optie als de standaardopdrachtuitvoer niet alle eigenschapsgegevens vastlegt.

Geaccepteerde waarden: false, true
Default value: False
--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource tag

Bewerken

Tag een resource.

az resource tag --tags
                [--api-version]
                [--ids]
                [--is-incremental]
                [--latest-include-preview]
                [--name]
                [--namespace]
                [--parent]
                [--resource-group]
                [--resource-type]

Voorbeelden

Tag de virtuele machine 'MyVm' met de sleutel 'vmlist' en de waarde 'vm1'.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Tag een web-app met de sleutel 'vmlist' en de waarde 'vm1', met behulp van een resource-id.

az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Tag de virtuele machine 'MyVm' met de sleutel 'vmlist' en de waarde 'vm1' incrementeel. De bestaande tags worden niet leeg.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i

Tag de virtuele machine 'MyVm' met de sleutel 'vmlist' en waarde 'vm1' met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Vereiste parameters

--tags

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

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--is-incremental -i

De optie om tags incrementeel toe te voegen zonder de oorspronkelijke tags te verwijderen. Als de sleutel van de nieuwe tag en de oorspronkelijke tag wordt gedupliceerd, wordt de oorspronkelijke waarde overschreven.

--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

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 resource update

Bewerken

Werk een resource bij op PUT-aanvraag.

Het ondersteunt de algemene update (met behulp van het eigenschapspad) om resources bij te werken. Als de updatebewerking mislukt, voert u 'az resource patch' uit.

az resource update [--add]
                   [--api-version]
                   [--force-string]
                   [--ids]
                   [--include-response-body {false, true}]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--remove]
                   [--resource-group]
                   [--resource-type]
                   [--set]

Voorbeelden

Werk een web-app bij met behulp van de nieuwste API-versie of deze versie een preview-versie is.

az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview

Een resource bijwerken. (automatisch gegenereerd)

az resource update --ids $id --set properties.connectionType=Proxy

Een resource bijwerken. (automatisch gegenereerd)

az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value

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: []
--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--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). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--include-response-body

Gebruik deze optie als de standaardopdrachtuitvoer niet alle eigenschapsgegevens vastlegt.

Geaccepteerde waarden: false, true
Default value: False
--latest-include-preview -v
Preview

Geef aan dat de nieuwste API-versie wordt gebruikt, ongeacht of deze preview-versie is (zoals 2020-01-01-preview) of niet. Als de ondersteunde API-versie van de resourceprovider bijvoorbeeld 2020-01-01-preview en 2019-01-01 is: bij het doorgeven van deze parameter wordt de nieuwste versie 2020-01-01-preview gebruikt, anders wordt de meest recente stabiele versie 2019-01-01 gebruikt zonder deze parameter door te geven.

Default value: False
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--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>.

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

--set

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

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

Bewerken

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een resources wordt voldaan.

az resource wait [--api-version]
                 [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--interval]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]
                 [--timeout]
                 [--updated]

Voorbeelden

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een resources wordt voldaan. (automatisch gegenereerd)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een resources wordt voldaan. (automatisch gegenereerd)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een resources wordt voldaan. (automatisch gegenereerd)

az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets

Optionele parameters

--api-version

De API-versie van de resource (laat weg voor de nieuwste stabiele versie).

--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
--ids

Een of meer resource-id's (met spatie gescheiden). Indien opgegeven, moeten er geen andere argumenten voor resource-id's worden opgegeven.

--include-response-body

Gebruik deze optie als de standaardopdrachtuitvoer niet alle eigenschapsgegevens vastlegt.

Geaccepteerde waarden: false, true
Default value: False
--interval

Polling-interval in seconden.

Default value: 30
--name -n

De resourcenaam. (Bijvoorbeeld: myC).

--namespace

Providernaamruimte (bijvoorbeeld: 'Microsoft.Provider').

--parent

Het bovenliggende pad (bijvoorbeeld: 'resA/myA/resB/myB').

--resource-group -g

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

--resource-type

Het resourcetype (bijvoorbeeld: 'resC'). Kan ook de indeling van de naamruimte/het type accepteren (bijvoorbeeld: 'Microsoft.Provider/resC').

--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.