az resource

Verwalten von Azure-Ressourcen.

Befehle

Name Beschreibung Typ Status
az resource create

Eine Ressource erstellen

Core Allgemein verfügbar
az resource delete

Löschen einer Ressource:

Core Allgemein verfügbar
az resource invoke-action

Rufen Sie eine Aktion für die Ressource auf.

Core Allgemein verfügbar
az resource link

Verwalten von Verknüpfungen zwischen Ressourcen.

Core Allgemein verfügbar
az resource link create

Erstellen Sie eine neue Verknüpfung zwischen Ressourcen.

Core Allgemein verfügbar
az resource link delete

Löschen sie eine Verknüpfung zwischen Ressourcen.

Core Allgemein verfügbar
az resource link list

Listenressourcenverknüpfung.

Core Allgemein verfügbar
az resource link show

Ruft eine Ressourcenverknüpfung mit der angegebenen ID ab.

Core Allgemein verfügbar
az resource link update

Verknüpfung zwischen Ressourcen aktualisieren.

Core Allgemein verfügbar
az resource list

Auflisten der Ressourcen.

Core Allgemein verfügbar
az resource lock

Verwalten von Sperren auf Azure-Ressourcenebene.

Core Allgemein verfügbar
az resource lock create

Erstellen Sie eine Sperre auf Ressourcenebene.

Core Allgemein verfügbar
az resource lock delete

Löschen Sie eine Sperre auf Ressourcenebene.

Core Allgemein verfügbar
az resource lock list

Listen Sie Sperrinformationen auf Ressourcenebene auf.

Core Allgemein verfügbar
az resource lock show

Zeigen Sie die Details einer Sperre auf Ressourcenebene an.

Core Allgemein verfügbar
az resource lock update

Aktualisieren sie eine Sperre auf Ressourcenebene.

Core Allgemein verfügbar
az resource move

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

Core Allgemein verfügbar
az resource patch

Aktualisieren Sie eine Ressource nach PATCH-Anforderung.

Core Allgemein verfügbar
az resource show

Rufen Sie die Details einer Ressource ab.

Core Allgemein verfügbar
az resource tag

Markieren Sie eine Ressource.

Core Allgemein verfügbar
az resource update

Aktualisieren Sie eine Ressource nach PUT-Anforderung.

Core Allgemein verfügbar
az resource wait

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

Core Allgemein verfügbar

az resource create

Eine Ressource erstellen

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

--api-version

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

--id

Ressourcen-ID

--is-full-object

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

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.

Standardwert: False
--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource delete

Löschen einer 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

--api-version

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

--ids

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

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

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--parent

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

--resource-group -g

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource invoke-action

Rufen Sie eine Aktion für die Ressource auf.

Eine Liste der möglichen Aktionen, die einer Ressource entsprechen, finden Sie unter https://docs.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, lautet https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} der Anforderungs-URI und die entsprechende Aktion powerOff. Dies finden Sie unter 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]

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. (automatisch generiert)

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

--api-version

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

--ids

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

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

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--parent

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

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource list

Auflisten der Ressourcen.

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

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--resource-group -g

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

--resource-type

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

--tag

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource move

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

--destination-subscription-id

Der Zielabonnementbezeichner.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource patch

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

--api-version

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

--ids

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

--is-full-object

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

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.

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource show

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

--api-version

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

--ids

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

--include-response-body

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

Zulässige Werte: false, true
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.

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource tag

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

--api-version

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

--ids

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

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

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource update

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 einer Ressource: (automatisch generiert)

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

Aktualisieren einer Ressource: (automatisch generiert)

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

Optionale Parameter

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

Standardwert: []
--api-version

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

--force-string

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

Standardwert: False
--ids

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

--include-response-body

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

Zulässige Werte: false, true
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.

Standardwert: False
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--remove

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

Standardwert: []
--resource-group -g

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

--resource-type

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

--set

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

Standardwert: []
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az resource wait

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. (automatisch generiert)

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. (automatisch generiert)

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. (automatisch generiert)

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

Optionale Parameter

--api-version

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

--created

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

Standardwert: False
--custom

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

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--ids

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

--include-response-body

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

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

Abrufintervall in Sekunden.

Standardwert: 30
--name -n

Der Name der Ressource. (z. B. myC).

--namespace

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

--parent

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

--resource-group -g

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

--resource-type

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.