az resource

  • Referens

Hantera Azure-resurser.

Kommandon

Name Description Typ Status
az resource create

Skapa en resurs.

 Kärna Allmän tillgänglighet
az resource delete

Ta bort en resurs.

 Kärna Allmän tillgänglighet
az resource invoke-action

Anropa en åtgärd på resursen.

 Kärna Allmän tillgänglighet
az resource link

Hantera länkar mellan resurser.

 Kärna Allmän tillgänglighet
az resource link create

Skapa en ny länk mellan resurser.

 Kärna Allmän tillgänglighet
az resource link delete

Ta bort en länk mellan resurser.

 Kärna Allmän tillgänglighet
az resource link list

Lista resurslänkar.

 Kärna Allmän tillgänglighet
az resource link show

Hämtar en resurslänk med det angivna ID:t.

 Kärna Allmän tillgänglighet
az resource link update

Uppdatera länken mellan resurser.

 Kärna Allmän tillgänglighet
az resource list

Visar resurserna.

 Kärna Allmän tillgänglighet
az resource lock

Hantera lås på Azure-resursnivå.

 Kärna Allmän tillgänglighet
az resource lock create

Skapa ett lås på resursnivå.

 Kärna Allmän tillgänglighet
az resource lock delete

Ta bort ett lås på resursnivå.

 Kärna Allmän tillgänglighet
az resource lock list

Lista låsinformation på resursnivå.

 Kärna Allmän tillgänglighet
az resource lock show

Visa information om ett lås på resursnivå.

 Kärna Allmän tillgänglighet
az resource lock update

Uppdatera ett lås på resursnivå.

 Kärna Allmän tillgänglighet
az resource move

Flytta resurser från en resursgrupp till en annan (kan finnas under en annan prenumeration).

 Kärna Allmän tillgänglighet
az resource patch

Uppdatera en resurs efter PATCH-begäran.

 Kärna Allmän tillgänglighet
az resource show

Hämta information om en resurs.

 Kärna Allmän tillgänglighet
az resource tag

Tagga en resurs.

 Kärna Allmän tillgänglighet
az resource update

Uppdatera en resurs efter PUT-begäran.

 Kärna Allmän tillgänglighet
az resource wait

Placera CLI i vänteläge tills ett villkor för en resurs uppfylls.

 Kärna Allmän tillgänglighet

az resource create

Redigera

Skapa en resurs.

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

Exempel

Skapa en API-app genom att tillhandahålla en fullständig JSON-konfiguration.

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}\" } }"

Skapa en resurs genom att läsa in JSON-konfigurationen från en fil.

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

Skapa en webbapp med den minsta nödvändiga konfigurationsinformationen.

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

Skapa en resurs med hjälp av den senaste API-versionen om den här versionen är en förhandsversion.

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

Skapa ett webbplatstillägg till en webbapp

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\" }"

Obligatoriska parametrar

--properties -p

En JSON-formaterad sträng som innehåller resursegenskaper.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--id

Resurs-ID.

--is-full-object

Ange att egenskapsobjektet innehåller andra alternativ, till exempel plats, taggar, sku och/eller plan.

standardvärde: False
--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource delete

Redigera

Ta bort en resurs.

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

Exempel

Ta bort en virtuell dator med namnet "MyVm".

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

Ta bort en webbapp med hjälp av en resursidentifierare.

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

Ta bort ett undernät med hjälp av en resursidentifierare.

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

Ta bort en virtuell dator med namnet "MyVm" med hjälp av den senaste api-versionen om den här versionen är en förhandsversion.

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource invoke-action

Redigera

Anropa en åtgärd på resursen.

En lista över möjliga åtgärder som motsvarar en resurs finns på https://docs.microsoft.com/rest/api/. Alla POST-begäranden är åtgärder som kan anropas och anges i slutet av URI-sökvägen. Om du till exempel vill stoppa en virtuell dator är https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} begärande-URI:n och motsvarande åtgärd .powerOff Detta finns på 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]

Exempel

Stäng av en virtuell dator som anges av ID.

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

Samla in information för en stoppad virtuell dator.

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

Anropa en åtgärd på resursen. (automatiskt genererad)

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

Obligatoriska parametrar

--action

Den åtgärd som ska anropas på den angivna resursen.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--request-body

JSON-kodade parameterargument för åtgärden som skickas i brödtexten efter begäran. Använd @{file} för att läsa in från en fil.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource list

Redigera

Visar resurserna.

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

Exempel

Visa en lista över alla resurser i regionen USA, västra.

az resource list --location westus

Visa en lista över alla resurser med namnet "resourceName".

az resource list --name 'resourceName'

Visa en lista över alla resurser med taggen "test".

az resource list --tag test

Visa en lista över alla resurser med en tagg som börjar med "test".

az resource list --tag 'test*'

Visa en lista över alla resurser med taggen "test" som har värdet "example".

az resource list --tag test=example

Valfria parametrar

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--tag

En enda tagg i formatet "key[=value]". Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource move

Redigera

Flytta resurser från en resursgrupp till en annan (kan finnas under en annan prenumeration).

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

Exempel

Flytta flera resurser till målresursgruppen under målprenumerationen

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

Obligatoriska parametrar

--destination-group

Målresursgruppens namn.

--ids

De utrymmesavgränsade resurs-ID:t som ska flyttas.

Valfria parametrar

--destination-subscription-id

Målprenumerationsidentifieraren.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource patch

Redigera

Uppdatera en resurs efter PATCH-begäran.

Den stöder uppdatering av resurser med JSON-formaterad sträng. Om korrigeringsåtgärden misslyckas kan du prova att köra "az resource update" i stället.

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

Exempel

Uppdatera en webbapp med hjälp av den senaste API-versionen om den här versionen är en förhandsversion.

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

Uppdatera en resurs med hjälp av JSON-konfiguration från en fil.

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

Uppdatera en API-app genom att tillhandahålla en JSON-konfiguration.

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}\" } }"

Obligatoriska parametrar

--properties -p

En JSON-formaterad sträng som innehåller resursegenskaper.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--is-full-object

Ange att egenskapsobjektet innehåller andra alternativ, till exempel plats, taggar, sku och/eller plan.

standardvärde: False
--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource show

Redigera

Hämta information om en resurs.

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

Exempel

Visa en virtuell datorresurs med namnet "MyVm".

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

Visa en webbapp med hjälp av en resursidentifierare.

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

Visa ett undernät.

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

Visa ett undernät med hjälp av en resursidentifierare.

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

Visa en sökvägsregel för application gateway.

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

Visa en virtuell datorresurs med namnet "MyVm" med hjälp av den senaste api-versionen om den här versionen är en förhandsversion.

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
standardvärde: False
--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource tag

Redigera

Tagga en resurs.

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

Exempel

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1".

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

Tagga en webbapp med nyckeln "vmlist" och värdet "vm1", med hjälp av en resursidentifierare.

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

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1" stegvis. Den tömmer inte befintliga taggar.

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

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1" med hjälp av den senaste api-versionen om den här versionen är en förhandsversion.

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

Obligatoriska parametrar

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--is-incremental -i

Alternativet att lägga till taggar stegvis utan att ta bort de ursprungliga taggarna. Om nyckeln för den nya taggen och den ursprungliga taggen dupliceras skrivs det ursprungliga värdet över.

--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource update

Redigera

Uppdatera en resurs efter PUT-begäran.

Den stöder den allmänna uppdateringen (med hjälp av egenskapssökvägen) för att uppdatera resurser. Om uppdateringsåtgärden misslyckas kan du prova att köra "az resource patch" i stället.

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]

Exempel

Uppdatera en webbapp med hjälp av den senaste API-versionen om den här versionen är en förhandsversion.

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

Uppdatera en resurs. (automatiskt genererad)

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

Uppdatera en resurs. (automatiskt genererad)

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

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

standardvärde: []
--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
standardvärde: False
--latest-include-preview -v
Förhandsgranskning

Ange att den senaste api-versionen ska användas oavsett om den är förhandsversion (till exempel 2020-01-01-preview) eller inte. Om till exempel api-versionen av resursprovidern som stöds är 2020-01-01-preview och 2019-01-01: när den här parametern skickas tar den senaste versionen 2020-01-01-preview, annars tar den senaste stabila versionen 2019-01-01 utan att skicka in den här parametern.

standardvärde: False
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

standardvärde: []
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

standardvärde: []
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az resource wait

Redigera

Placera CLI i vänteläge tills ett villkor för en resurs uppfylls.

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]

Exempel

Placera CLI i vänteläge tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Placera CLI i vänteläge tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Placera CLI i vänteläge tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Om detta anges ska inga andra "Resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
standardvärde: False
--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--name -n

Resursnamnet. (Ex: myC).

--namespace

Providernamnområde (t.ex. Microsoft.Provider).

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--resource-type

Resurstypen (till exempel "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.