Auf Englisch lesen

Freigeben über

New-AzApplicationGatewayPathRuleConfig

  • Referenz
Modul:
Az.Network

Erstellt eine Anwendungsgatewaypfadregel.

Syntax

PowerShell 
New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RewriteRuleSetId <String>]
   [-RedirectConfigurationId <String>]
   [-FirewallPolicyId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell 
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 Pfadregel für das Anwendungsgateway. 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

PowerShell 
$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 die Add-AzApplicationGatewayUrlPathMapConfig Cmdlet, 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

PowerShell 
$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 erstellen, indem Sie das cmdlet New-AzApplicationGatewayBackendAddressPool und die Syntax wie folgt verwenden: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Der obige Befehl fügt dem Adresspool zwei IP-Adressen (192.16.1.1 und 192.168.1.2) hinzu. 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 DefaultBackendAddressPool Parameter 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 die DefaultBackendAddressPoolId Parameter im selben Befehl nicht 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 DefaultBackendAddressPool Parameter 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 Parameter DefaultBackendAddressPool Parameter verwendet werden: -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 DefaultBackendHttpSettingsId Parameter 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 dann den parameter DefaultBackendHttpSettingsId anstelle des DefaultBackendHttpSettings Parameter 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 DefaultBackendHttpSettings Parameter 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 New-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlets 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-AzApplicationGatewayFirewallPolicySettings bzw. 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 wir über die ID verfügen, können Sie FirewallPolicyId Parameter anstelle FirewallPolicy Parameter 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