az network front-door routing-rule

Note

This reference is part of the front-door extension for the Azure CLI (version 2.67.0 or higher). Die Erweiterung wird automatisch installiert, wenn Sie ein az Netzwerk Front-Door Routing-Regel Befehl ausführen. Learn more about extensions.

Verwalten von Regeln für das Routing von Front Door.

Befehle

Name	Beschreibung	Typ	Status
az network front-door routing-rule create	Erstellen Sie eine Vortür-Routingregel.	Extension	GA
az network front-door routing-rule delete	Löschen einer Vortürroutingregel.	Extension	GA
az network front-door routing-rule list	Regeln für die Weiterleitung von Vortüren auflisten.	Extension	GA
az network front-door routing-rule show	Rufen Sie die Details einer Front Door-Routingregel ab.	Extension	GA
az network front-door routing-rule update	Aktualisieren einer Vortürroutingregel.	Extension	GA

az network front-door routing-rule create

Erstellen Sie eine Vortür-Routingregel.

Erstellen Sie eine Front Door-Routingregel, um die Anforderungen entweder an ein Back-End weiterzuleiten oder die Benutzer an eine andere URL umzuleiten.

Beispiel 1: az-Front-Door-Routingregel create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Beispiel 2: az Network Front-Door Routing-Rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string query-query-querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--frontend-endpoints

Leerzeichentrennte Liste der Front-End-Endpunktnamen oder -IDs.

--name -n

Name der Routingregel.

--resource-group -g

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

--route-type

Routentyp, um zu definieren, wie Front Door Anforderungen für diese Route verarbeiten soll, d. h. sie an ein Back-End weiterleiten oder die Benutzer an eine andere URL umleiten sollen.

Eigenschaft	Wert
Parameter group:	Routing Rule Arguments
Zulässige Werte:	Forward, Redirect

Optionale Parameter

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

--accepted-protocols

Durch Leerzeichen getrennte Liste der zu akzeptierenden Protokolle. Default: Http.

--backend-pool

Name oder ID eines Back-End-Pools. Es ist erforderlich, eine Weiterleitungsregel zu erstellen.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--cache-duration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist iso 8601 Dauer.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--caching

Gibt an, ob die Zwischenspeicherung für diese Route aktiviert werden soll.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	Disabled, Enabled

--custom-forwarding-path

Benutzerdefinierter Pfad zum Umschreiben von Ressourcenpfaden, die mit dieser Regel übereinstimmen. Lassen Sie leer, um den eingehenden Pfad zu verwenden.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--custom-fragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL, die nach #kommt. Schließen Sie die Datei "#" nicht ein.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-host

Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-path

Der vollständige Pfad zur Umleitung. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-query-string

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt; Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss im <key>=<value> Format vorliegen. Die erste ? und & werden automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, sondern trennen Sie mehrere Abfragezeichenfolgen mit &.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--disabled

Erstellen sie in einem deaktivierten Zustand.

Eigenschaft	Wert
Zulässige Werte:	false, true

--dynamic-compression

Verwenden Sie die dynamische Komprimierung für zwischengespeicherte Inhalte.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	Disabled, Enabled

--forwarding-protocol

Protokoll zur Weiterleitung von Datenverkehr.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	HttpOnly, HttpsOnly, MatchRequest

--patterns

Mit Leerzeichen getrennte Liste von Mustern, die übereinstimmen sollen. Default: '/*'.

--query-parameter-strip-directive

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	StripAll, StripAllExcept, StripNone, StripOnly

--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt), wenn sie den Typ StripAllExcept oder StripOnly verwenden.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--redirect-protocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments
Standardwert:	MatchRequest
Zulässige Werte:	HttpOnly, HttpsOnly, MatchRequest

--redirect-type

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments
Standardwert:	Moved
Zulässige Werte:	Found, Moved, PermanentRedirect, TemporaryRedirect

--rules-engine

Name oder ID einer Regelmodulkonfiguration. Um die Verknüpfungseigenschaft aufzuheben, "--remove rulesEngine".

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 network front-door routing-rule delete

Löschen einer Vortürroutingregel.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

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

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 network front-door routing-rule list

Regeln für die Weiterleitung von Vortüren auflisten.

az network front-door routing-rule list --front-door-name
                                        --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--resource-group -g

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

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 network front-door routing-rule show

Rufen Sie die Details einer Front Door-Routingregel ab.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

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

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 network front-door routing-rule update

Aktualisieren einer Vortürroutingregel.

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

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

Optionale Parameter

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

--accepted-protocols

Durch Leerzeichen getrennte Liste der zu akzeptierenden Protokolle. Default: Http.

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

--backend-pool

Name oder ID eines Back-End-Pools. Es ist erforderlich, eine Weiterleitungsregel zu erstellen.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--cache-duration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist iso 8601 Dauer.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--caching

Gibt an, ob die Zwischenspeicherung für diese Route aktiviert werden soll.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	Disabled, Enabled

--custom-forwarding-path

Benutzerdefinierter Pfad zum Umschreiben von Ressourcenpfaden, die mit dieser Regel übereinstimmen. Lassen Sie leer, um den eingehenden Pfad zu verwenden.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--custom-fragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL, die nach #kommt. Schließen Sie die Datei "#" nicht ein.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-host

Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-path

Der vollständige Pfad zur Umleitung. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--custom-query-string

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt; Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss im <key>=<value> Format vorliegen. Die erste ? und & werden automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, sondern trennen Sie mehrere Abfragezeichenfolgen mit &.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments

--dynamic-compression

Verwenden Sie die dynamische Komprimierung für zwischengespeicherte Inhalte.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	Disabled, Enabled

--enabled

Enabled status.

Eigenschaft	Wert
Parameter group:	Probe Setting Arguments
Zulässige Werte:	Disabled, Enabled

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

--forwarding-protocol

Protokoll zur Weiterleitung von Datenverkehr.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	HttpOnly, HttpsOnly, MatchRequest

--frontend-endpoints

Leerzeichentrennte Liste der Front-End-Endpunktnamen oder -IDs.

--patterns

Mit Leerzeichen getrennte Liste von Mustern, die übereinstimmen sollen. Default: '/*'.

--query-parameter-strip-directive

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments
Zulässige Werte:	StripAll, StripAllExcept, StripNone, StripOnly

--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt), wenn sie den Typ StripAllExcept oder StripOnly verwenden.

Eigenschaft	Wert
Parameter group:	Forward Routing Rule Arguments

--redirect-protocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments
Zulässige Werte:	HttpOnly, HttpsOnly, MatchRequest

--redirect-type

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Eigenschaft	Wert
Parameter group:	Redirect Routing Rule Arguments
Zulässige Werte:	Found, Moved, PermanentRedirect, TemporaryRedirect

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

--rules-engine

Name oder ID einer Regelmodulkonfiguration. Um die Verknüpfungseigenschaft aufzuheben, "--remove rulesEngine".

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