Freigeben über

New-AzApplicationGatewayPathRuleConfig

  • Referenz
Modul:
Az.Network

Erstellt eine Anwendungsgatewaypfadregel.

Syntax

New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RewriteRuleSetId <String>]
   [-RedirectConfigurationId <String>]
   [-FirewallPolicyId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzApplicationGatewayPathRuleConfig erstellt eine Anwendungsgatewaypfadregel. Von diesem Cmdlet erstellte Regeln können einer Sammlung von Konfigurationseinstellungen für die URL-Pfadzuordnung hinzugefügt und dann einem Gateway zugewiesen werden. Pfadzuordnungskonfigurationseinstellungen werden im Lastenausgleich des Anwendungsgateways verwendet.

Beispiele

Beispiel 1

$Gateway = Get-AzApplicationGateway -Name "ContosoApplicationGateway"
$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
$HttpSettings = New-AzApplicationGatewayBackendHttpSetting -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
Add-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

Diese Befehle erstellen eine neue Anwendungsgatewaypfadregel und verwenden dann das Cmdlet Add-AzApplicationGatewayUrlPathMapConfig , um diese Regel einem Anwendungsgateway zuzuweisen. Dazu erstellt der erste Befehl einen Objektverweis auf das Gateway ContosoApplicationGateway. Dieser Objektverweis wird in einer Variablen namens $Gateway gespeichert. Die nächsten beiden Befehle erstellen einen Back-End-Adresspool und ein Back-End-HTTP-Einstellungsobjekt; Diese Objekte (die in den Variablen $AddressPool und $HttpSettings gespeichert sind) sind erforderlich, um ein Pfadregelobjekt zu erstellen. Der vierte Befehl erstellt das Pfadregelobjekt und wird in einer Variablen namens $PathRuleConfig gespeichert. Der fünfte Befehl verwendet Add-AzApplicationGatewayUrlPathMapConfig , um die Konfigurationseinstellungen und die neue Pfadregel in diesen Einstellungen zu ContosoApplicationGateway hinzuzufügen.

Beispiel 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

Mit diesem Befehl wird eine Pfadregel mit dem Namen als "base", "Pfad" als "/base", "Back-EndAddressPool" als $AddressPool, Back-EndHttpSettings als $HttpSettings und FirewallPolicy als $firewallPolicy.ngs und die neue Pfadregel erstellt, die in diesen Einstellungen in ContosoApplicationGateway enthalten ist.

Parameter

-BackendAddressPool

Gibt einen Objektverweis auf eine Auflistung von Back-End-Adresspooleinstellungen an, die den Konfigurationseinstellungen für Gatewaypfadregeln hinzugefügt werden sollen. Sie können diesen Objektverweis mithilfe des Cmdlets New-AzApplicationGatewayBackendAddressPool und ähnlich der folgenden Syntax erstellen: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Mit dem vorherigen Befehl werden dem Adresspool zwei IP-Adressen (192.16.1.1 und 192.168.1.2) hinzugefügt. Beachten Sie, dass die IP-Adresse in Anführungszeichen gesetzt und durch Kommas getrennt wird. Die resultierende Variable $AddressPool kann dann als Parameterwert für den Parameter DefaultBackendAddressPool verwendet werden. Der Back-End-Adresspool stellt die IP-Adressen auf den Back-End-Servern dar. Diese IP-Adressen sollten entweder zum subnetz des virtuellen Netzwerks gehören oder öffentliche IP-Adressen sein. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendAddressPoolId nicht im selben Befehl verwenden.

Typ:PSApplicationGatewayBackendAddressPool
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackendAddressPoolId

Gibt die ID eines vorhandenen Back-End-Adresspools an, der den Konfigurationseinstellungen der Gatewaypfadregel hinzugefügt werden kann. Adresspool-IDs können mithilfe des Cmdlets "Get-AzApplicationGatewayBackendAddressPool" zurückgegeben werden. Nachdem Sie über die ID verfügen, können Sie den Parameter DefaultBackendAddressPoolId anstelle des Parameters DefaultBackendAddressPool verwenden. Beispiel: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Der Back-End-Adresspool stellt die IP-Adressen auf den Back-End-Servern dar. Diese IP-Adressen sollten entweder zum subnetz des virtuellen Netzwerks gehören oder öffentliche IP-Adressen sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackendHttpSettings

Gibt einen Objektverweis auf eine Auflistung von BACK-End-HTTP-Einstellungen an, die den Konfigurationseinstellungen für Gatewaypfadregel hinzugefügt werden sollen. Sie können diesen Objektverweis mithilfe des Cmdlets New-AzApplicationGatewayBackendHttpSettings und der folgenden Syntax erstellen: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Die resultierende Variable, $HttpSettings, kann dann als Parameterwert für den DefaultBackendAddressPool verwendet werden. parameter: -DefaultBackendHttpSettings $HttpSettings Die Back-End-HTTP-Einstellungen konfigurieren Eigenschaften wie Port, Protokoll und cookiebasierte Affinität für einen Back-End-Pool. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendHttpSettingsId nicht im selben Befehl verwenden.

Typ:PSApplicationGatewayBackendHttpSettings
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackendHttpSettingsId

Gibt die ID einer vorhandenen Back-End-HTTP-Einstellungsauflistung an, die den Konfigurationseinstellungen für Gatewaypfadregel hinzugefügt werden kann. HTTP-Einstellungs-IDs können mithilfe des Cmdlets "Get-AzApplicationGatewayBackendHttpSettings" zurückgegeben werden. Nachdem Sie über die ID verfügen, können Sie den Parameter DefaultBackendHttpSettingsId anstelle des Parameters DefaultBackendHttpSettings verwenden. Beispiel: -DefaultBackendSettings ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backHttpSettingsCollection/ContosoHttpSettings" Die Back-End-HTTP-Einstellungen konfigurieren Eigenschaften wie Port, Protokoll und cookiebasierte Affinität für einen Back-End-Pool. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendHttpSettings nicht im selben Befehl verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirewallPolicy

Gibt den Objektverweis auf eine Firewallrichtlinie der obersten Ebene an. Der Objektverweis kann mithilfe des Cmdlets New-AzApplicationGatewayWebApplicationFirewallPolicy erstellt werden. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Eine mit dem obigen Commandlet erstellte Firewallrichtlinie kann auf Pfadregelebene verwiesen werden. er oberhalb des Befehls würde eine Standardrichtlinieneinstellungen und verwaltete Regeln erstellen. Anstelle der Standardwerte können Benutzer PolicySettings, ManagedRules mithilfe von New-AzApplicationGatewallPolicySettings und New-AzApplicationGatewayFirewallPolicyManagedRules angeben.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirewallPolicyId

Gibt die ID einer vorhandenen Webanwendungsfirewallressource der obersten Ebene an. Firewallrichtlinien-IDs können mithilfe des Cmdlets "Get-AzApplicationGatewayWebApplicationFirewallPolicy" zurückgegeben werden. Nachdem die ID vorhanden ist, können Sie den Parameter "FirewallPolicyId" anstelle des Parameters "FirewallPolicy" verwenden. Beispiel: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Pfadregelkonfiguration an, die dieses Cmdlet erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Paths

Gibt eine oder mehrere Anwendungsgatewaypfadregeln an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Typ:PSApplicationGatewayRedirectConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RedirectConfigurationId

ID des Anwendungsgateways RedirectConfiguration

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Typ:PSApplicationGatewayRewriteRuleSet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RewriteRuleSetId

ID des Anwendungsgateways RewriteRuleSet

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSApplicationGatewayPathRule