Freigeben über

az resource

Verwalten von Azure-Ressourcen.

Befehle

Name Beschreibung Typ Status
az resource create

Erstellen Sie eine Ressource.

 Core GA
az resource delete

Löschen sie eine Ressource.

 Core GA
az resource invoke-action

Rufen Sie eine Aktion für die Ressource auf.

 Core GA
az resource link

Verwalten von Verknüpfungen zwischen Ressourcen.

 Core GA
az resource link create

Erstellen Sie eine neue Verknüpfung zwischen Ressourcen.

 Core GA
az resource link delete

Löschen sie eine Verknüpfung zwischen Ressourcen.

 Core GA
az resource link list

Listenressourcenverknüpfung.

 Core GA
az resource link show

Ruft eine Ressourcenverknüpfung mit der angegebenen ID ab.

 Core GA
az resource link update

Verknüpfung zwischen Ressourcen aktualisieren.

 Core GA
az resource list

List resources.

 Core GA
az resource lock

Verwalten von Sperren auf Azure-Ressourcenebene.

 Core GA
az resource lock create

Erstellen Sie eine Sperre auf Ressourcenebene.

 Core GA
az resource lock delete

Löschen Sie eine Sperre auf Ressourcenebene.

 Core GA
az resource lock list

Listen Sie Sperrinformationen auf Ressourcenebene auf.

 Core GA
az resource lock show

Zeigen Sie die Details einer Sperre auf Ressourcenebene an.

 Core GA
az resource lock update

Aktualisieren sie eine Sperre auf Ressourcenebene.

 Core GA
az resource move

Verschieben von Ressourcen aus einer Ressourcengruppe in eine andere (kann unter einem anderen Abonnement stehen).

 Core GA
az resource patch

Aktualisieren Sie eine Ressource nach PATCH-Anforderung.

 Core GA
az resource show

Rufen Sie die Details einer Ressource ab.

 Core GA
az resource tag

Markieren Sie eine Ressource.

 Core GA
az resource update

Aktualisieren Sie eine Ressource nach PUT-Anforderung.

 Core GA
az resource wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Ressource erfüllt ist.

 Core GA

az resource create

Bearbeiten

Erstellen Sie eine Ressource.

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

Beispiele

Erstellen Sie eine API-App, indem Sie eine vollständige JSON-Konfiguration bereitstellen.

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

Erstellen Sie eine Ressource, indem Sie die JSON-Konfiguration aus einer Datei laden.

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

Erstellen Sie eine Web-App mit den erforderlichen Mindestkonfigurationsinformationen.

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

Erstellen Sie eine Ressource mithilfe der neuesten API-Version, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Erstellen einer Websiteerweiterung für eine 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\" }"

Erforderliche Parameter

--properties -p

Eine JSON-formatierte Zeichenfolge mit Ressourceneigenschaften.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--id

Resource ID.

--is-full-object

Geben Sie an, dass das Eigenschaftenobjekt weitere Optionen wie Ort, Tags, Sku und/oder Plan enthält.

Eigenschaft Wert
Standardwert: False
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource delete

Bearbeiten

Löschen sie eine Ressource.

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

Beispiele

Löschen Sie einen virtuellen Computer namens "MyVm".

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

Löschen Sie eine Web-App mithilfe eines Ressourcenbezeichners.

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

Löschen sie ein Subnetz mithilfe eines Ressourcenbezeichners.

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

Löschen Sie einen virtuellen Computer namens "MyVm", indem Sie die neueste API-Version verwenden, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource invoke-action

Bearbeiten

Rufen Sie eine Aktion für die Ressource auf.

Eine Liste der möglichen Aktionen, die einer Ressource entsprechen, finden Sie unter https://learn.microsoft.com/rest/api/. Alle POST-Anforderungen sind Aktionen, die aufgerufen werden können und am Ende des URI-Pfads angegeben werden. Um beispielsweise einen virtuellen Computer zu beenden, wird der Anforderungs-URI https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} und die entsprechende Aktion powerOff. Dies finden Sie unter https://learn.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]

Beispiele

Schalten Sie einen virtuellen Computer aus, der durch die ID angegeben wird.

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

Erfassen Sie Informationen für einen beendeten virtuellen Computer.

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

Rufen Sie eine Aktion für die Ressource auf. (autogenerated)

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

Erforderliche Parameter

--action

Die Aktion, die für die angegebene Ressource aufgerufen wird.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--request-body

JSON-codierte Parameterargumente für die Aktion, die im Postanforderungstext übergeben wird. Verwenden Sie @{file} zum Laden aus einer Datei.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource list

Bearbeiten

List resources.

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

Beispiele

Listet alle Ressourcen in der Region West-USA auf.

az resource list --location westus

Listet alle Ressourcen mit dem Namen 'resourceName' auf.

az resource list --name 'resourceName'

Listet alle Ressourcen mit dem Tag "test" auf.

az resource list --tag test

Auflisten aller Ressourcen mit einem Tag, das mit "test" beginnt.

az resource list --tag 'test*'

Auflisten aller Ressourcen mit dem Tag "test" mit dem Wert "example".

az resource list --tag test=example

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--name -n

Der Ressourcenname. (Ex: myC).

--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--tag

Ein einzelnes Tag im Format "key[=value]". Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource move

Bearbeiten

Verschieben von Ressourcen aus einer Ressourcengruppe in eine andere (kann unter einem anderen Abonnement stehen).

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

Beispiele

Verschieben mehrerer Ressourcen in die Zielressourcengruppe unter dem Zielabonnement

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

Erforderliche Parameter

--destination-group

Der Name der Zielressourcengruppe.

--ids

Die durch Leerzeichen getrennten Ressourcen-IDs, die verschoben werden sollen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--destination-subscription-id

Der Zielabonnementbezeichner.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource patch

Bearbeiten

Aktualisieren Sie eine Ressource nach PATCH-Anforderung.

Es unterstützt das Aktualisieren von Ressourcen mit JSON-formatierter Zeichenfolge. Wenn der Patchvorgang fehlschlägt, führen Sie stattdessen "az resource update" aus.

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

Beispiele

Aktualisieren Sie eine Webapp mithilfe der neuesten API-Version, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Aktualisieren Sie eine Ressource mithilfe der JSON-Konfiguration aus einer Datei.

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

Aktualisieren Sie eine API-App, indem Sie eine JSON-Konfiguration bereitstellen.

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

Erforderliche Parameter

--properties -p

Eine JSON-formatierte Zeichenfolge mit Ressourceneigenschaften.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--is-full-object

Geben Sie an, dass das Eigenschaftenobjekt weitere Optionen wie Ort, Tags, Sku und/oder Plan enthält.

Eigenschaft Wert
Standardwert: False
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource show

Bearbeiten

Rufen Sie die Details einer Ressource ab.

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

Beispiele

Anzeigen einer Vm-Ressource mit dem Namen "MyVm".

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

Anzeigen einer Web-App mithilfe eines Ressourcenbezeichners

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

Ein Subnetz anzeigen.

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

Zeigen Sie ein Subnetz mit einem Ressourcenbezeichner an.

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

Anzeigen einer Anwendungsgatewaypfadregel.

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

Anzeigen einer Vm-Ressource mit dem Namen "MyVm" mithilfe der neuesten API-Version, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--include-response-body

Verwenden Sie diese Methode, wenn die Standardbefehlsausgabe nicht alle Eigenschaftendaten erfasst.

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource tag

Bearbeiten

Markieren Sie eine Ressource.

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

Beispiele

Markieren Sie den virtuellen Computer "MyVm" mit dem Schlüssel "vmlist" und dem Wert "vm1".

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

Markieren Sie eine Web-App mit dem Schlüssel "vmlist" und dem Wert "vm1", indem Sie einen Ressourcenbezeichner verwenden.

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

Markieren Sie den virtuellen Computer "MyVm" mit dem Schlüssel "vmlist" und dem Wert "vm1" inkrementell. Die vorhandenen Tags werden nicht geleert.

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

Markieren Sie den virtuellen Computer "MyVm" mit dem Schlüssel "vmlist" und dem Wert "vm1", indem Sie die neueste API-Version verwenden, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Erforderliche Parameter

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--is-incremental -i

Die Option zum inkrementellen Hinzufügen von Tags, ohne die ursprünglichen Tags zu löschen. Wenn der Schlüssel des neuen Tags und des ursprünglichen Tags dupliziert wird, wird der ursprüngliche Wert überschrieben.

--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource update

Bearbeiten

Aktualisieren Sie eine Ressource nach PUT-Anforderung.

Es unterstützt das generische Update (mithilfe des Eigenschaftspfads), um Ressourcen zu aktualisieren. Wenn der Aktualisierungsvorgang fehlschlägt, führen Sie stattdessen "az resource patch" aus.

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]

Beispiele

Aktualisieren Sie eine Webapp mithilfe der neuesten API-Version, ob es sich bei dieser Version um eine Vorschauversion handelt.

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

Aktualisieren sie eine Ressource. (autogenerated)

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

Aktualisieren sie eine Ressource. (autogenerated)

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: False
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--include-response-body

Verwenden Sie diese Methode, wenn die Standardbefehlsausgabe nicht alle Eigenschaftendaten erfasst.

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--latest-include-preview -v
Vorschau

Geben Sie an, dass die neueste API-Version verwendet wird, unabhängig davon, ob es sich um eine Vorschauversion (z. B. 2020-01-01-01-Preview) handelt oder nicht. Wenn die unterstützte API-Version des Ressourcenanbieters beispielsweise 2020-01-01-preview und 2019-01-01 lautet: Wenn Sie diesen Parameter übergeben, wird die neueste Version 2020-01-01-Preview verwendet, andernfalls wird die neueste stabile Version 2019-01-01-01 verwendet, ohne diesen Parameter zu übergeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Standardwert: False
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az resource wait

Bearbeiten

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Ressource erfüllt ist.

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]

Beispiele

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Ressource erfüllt ist. (autogenerated)

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

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Ressource erfüllt ist. (autogenerated)

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

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Ressource erfüllt ist. (autogenerated)

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

Die API-Version der Ressource (für die neueste stabile Version weglassen).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Eigenschaft Wert
Parameter group: Wait Condition Arguments
--deleted

Warten Sie, bis sie gelöscht wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Wenn angegeben, sollten keine anderen Argumente für "Ressourcen-ID" angegeben werden.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--include-response-body

Verwenden Sie diese Methode, wenn die Standardbefehlsausgabe nicht alle Eigenschaftendaten erfasst.

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--interval

Abrufintervall in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 30
--name -n

Der Ressourcenname. (Ex: myC).

Eigenschaft Wert
Parameter group: Resource Id Arguments
--namespace

Anbieternamespace (z. B. 'Microsoft.Provider').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--parent

Der übergeordnete Pfad (z. B. "resA/myA/resB/myB").

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-type

Der Ressourcentyp (z. B. 'resC'). Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Provider/resC').

Eigenschaft Wert
Parameter group: Resource Id Arguments
--timeout

Maximale Wartezeit in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False