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 $Http Einstellungen 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-EndHttp Einstellungen als $Http Einstellungen und FirewallPolicy als $firewallPolicy.ngs und die neue Pfadregel erstellt, die in diesen Einstellungen für 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.

Type:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Einstellungen und der folgenden Syntax erstellen: $Http Einstellungen = New-AzApplicationGatewayBackendHttp Einstellungen -Name "ContosoHttp Einstellungen" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Die resultierende Variable, $HttpEinstellungen kann dann als Parameterwert für den DefaultBackendAddressPool-Parameter: -DefaultBackendHttp Einstellungen $Http Einstellungen 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 DefaultBackendHttp Einstellungen Id nicht im selben Befehl verwenden.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Einstellungen zurückgegeben werden. Nachdem Sie über die ID verfügen, können Sie den Parameter DefaultBackendHttp Einstellungen Id anstelle des Parameters DefaultBackendHttp Einstellungen verwenden. Beispiel: -DefaultBackend Einstellungen ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Einstellungen Collection/ContosoHttp Einstellungen" 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 DefaultBackendHttp Einstellungen nicht im selben Befehl verwenden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Richtlinien Einstellungen, ManagedRules mithilfe von New-AzApplicationGatewayFirewallPolicy Einstellungen und New-AzApplicationGatewayFirewallPolicyManagedRules angeben.

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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>

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

Gibt eine oder mehrere Anwendungsgatewaypfadregeln an.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Type:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfigurationId

ID des Anwendungsgateways RedirectConfiguration

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Type:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RewriteRuleSetId

ID des Anwendungsgateways RewriteRuleSet

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

PSApplicationGatewayPathRule