New-AzApplicationGatewayPathRuleConfig
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
Ähnliche Themen
- Add-AzApplicationGatewayUrlPathMapConfig
- Get-AzApplicationGateway
- Get-AzApplicationGatewayUrlPathMapConfig
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayPathRuleConfig
- New-AzApplicationGatewayUrlPathMapConfig
- Remove-AzApplicationGatewayUrlPathMapConfig
- Set-AzApplicationGatewayUrlPathMapConfig
Azure PowerShell