az network application-gateway rule

  • Referenz

Evaluieren Sie Prüfpunktinformationen, und definieren Sie HTTP/HTTPS-Routingregeln.

Weitere Informationen finden Sie unter https://video2.skills-academy.com/en-us/azure/web-application-firewall/ag/application-gateway-customize-waf-rules-cli.

Befehle

Name Beschreibung Typ Status
az network application-gateway rule create

Erstellen Sie eine Regel.

 Kernspeicher Allgemein verfügbar
az network application-gateway rule delete

Löschen sie eine Regel.

 Kernspeicher Allgemein verfügbar
az network application-gateway rule list

Listenregeln.

 Kernspeicher Allgemein verfügbar
az network application-gateway rule show

Rufen Sie die Details einer Regel ab.

 Kernspeicher Allgemein verfügbar
az network application-gateway rule update

Aktualisieren einer Regel.

 Kernspeicher Allgemein verfügbar
az network application-gateway rule wait

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

 Kernspeicher Allgemein verfügbar

az network application-gateway rule create

Bearbeiten

Erstellen Sie eine Regel.

Regeln werden in der Reihenfolge ausgeführt, in der sie erstellt werden.

az network application-gateway rule create --gateway-name
                                           --name
                                           --resource-group
                                           [--address-pool]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--url-path-map]

Beispiele

Erstellen Sie eine Einfache Regel.

az network application-gateway rule create -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyBackendListener --rule-type Basic --address-pool MyAddressPool --http-settings MyHttpSettings

Erforderliche Parameter

--gateway-name

Name des Anwendungsgateways.

--name -n

Name der Anforderungsroutingregel.

--resource-group -g

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

Optionale Parameter

--address-pool

Name oder ID des Back-End-Adresspools. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--http-listener

Name oder ID des HTTP-Listeners. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--http-settings

Name oder ID der HTTP-Einstellungen. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--priority

Priorität der Anforderungsroutingregel. Unterstützte SKU-Ebenen sind Standard_v2, WAF_v2.

--redirect-config

Name oder ID der Umleitungskonfiguration, die mit der erstellten Regel verwendet werden soll.

--rewrite-rule-set

Name oder ID des Neuschreibregelsatzes.

--rule-type

Typ der Anforderungsroutingregel.

Zulässige Werte: Basic, PathBasedRouting
Standardwert: Basic
--url-path-map

Name oder ID der URL-Pfadzuordnung.

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 network application-gateway rule delete

Bearbeiten

Löschen sie eine Regel.

az network application-gateway rule delete --gateway-name
                                           --name
                                           --resource-group
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Beispiele

Löschen sie eine Regel.

az network application-gateway rule delete -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

Erforderliche Parameter

--gateway-name

Name des Anwendungsgateways.

--name -n

Name der Anforderungsroutingregel.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
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 network application-gateway rule list

Bearbeiten

Listenregeln.

az network application-gateway rule list --gateway-name
                                         --resource-group

Beispiele

Listenregeln.

az network application-gateway rule list -g MyResourceGroup --gateway-name MyAppGateway

Erforderliche Parameter

--gateway-name

Name des Anwendungsgateways.

--resource-group -g

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

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 network application-gateway rule show

Bearbeiten

Rufen Sie die Details einer Regel ab.

az network application-gateway rule show --gateway-name
                                         --name
                                         --resource-group

Beispiele

Rufen Sie die Details einer Regel ab.

az network application-gateway rule show -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

Erforderliche Parameter

--gateway-name

Name des Anwendungsgateways.

--name -n

Name der Anforderungsroutingregel.

--resource-group -g

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

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 network application-gateway rule update

Bearbeiten

Aktualisieren einer Regel.

az network application-gateway rule update --gateway-name
                                           --name
                                           --resource-group
                                           [--add]
                                           [--address-pool]
                                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--remove]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--set]
                                           [--url-path-map]

Beispiele

Aktualisieren Einer Regel wird ein neuer HTTP-Listener verwendet.

az network application-gateway rule update -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyNewBackendListener

Erforderliche Parameter

--gateway-name

Name des Anwendungsgateways.

--name -n

Name der Anforderungsroutingregel.

--resource-group -g

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

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

--address-pool

Name oder ID des Back-End-Adresspools. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--force-string

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

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--http-listener

Name oder ID des HTTP-Listeners. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--http-settings

Name oder ID der HTTP-Einstellungen. Wenn nur eine vorhanden ist, lassen Sie die Verwendung als Standard aus.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--priority

Priorität der Anforderungsroutingregel. Unterstützte SKU-Ebenen sind Standard_v2, WAF_v2.

--redirect-config

Name oder ID der Umleitungskonfiguration, die mit der erstellten Regel verwendet werden soll.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--rewrite-rule-set

Name oder ID des Neuschreibregelsatzes.

--rule-type

Typ der Anforderungsroutingregel.

Zulässige Werte: Basic, PathBasedRouting
--set

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

--url-path-map

Name oder ID der URL-Pfadzuordnung.

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 network application-gateway rule wait

Bearbeiten

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

az network application-gateway rule wait [--created]
                                         [--custom]
                                         [--deleted]
                                         [--exists]
                                         [--gateway-name]
                                         [--ids]
                                         [--interval]
                                         [--resource-group]
                                         [--subscription]
                                         [--timeout]
                                         [--updated]

Optionale Parameter

--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
--gateway-name

Name des Anwendungsgateways.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--resource-group -g

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

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

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