Delen via

New-AzApplicationGatewayPathRuleConfig

  • Referentie
Module:
Az.Network

Hiermee maakt u een padregel voor de toepassingsgateway.

Syntaxis

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

Description

Met de cmdlet New-AzApplicationGatewayPathRuleConfig maakt u een padregel voor de toepassingsgateway. Regels die door deze cmdlet worden gemaakt, kunnen worden toegevoegd aan een verzameling configuratie-instellingen voor URL-padtoewijzing en vervolgens toegewezen aan een gateway. Configuratie-instellingen voor padtoewijzing worden gebruikt in taakverdeling voor application gateways.

Voorbeelden

Voorbeeld 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

Met deze opdrachten maakt u een nieuwe padregel voor de toepassingsgateway en gebruikt u vervolgens de cmdlet Add-AzApplicationGatewayUrlPathMapConfig om die regel toe te wijzen aan een toepassingsgateway. Hiervoor maakt de eerste opdracht een objectverwijzing naar de gateway ContosoApplicationGateway. Deze objectverwijzing wordt opgeslagen in een variabele met de naam $Gateway. Met de volgende twee opdrachten maakt u een back-endadresgroep en een http-instellingenobject voor de back-end; deze objecten (opgeslagen in de variabelen $AddressPool en $HttpSettings) zijn nodig om een padregelobject te maken. Met de vierde opdracht wordt het padregelobject gemaakt en opgeslagen in een variabele met de naam $PathRuleConfig. De vijfde opdracht maakt gebruik van Add-AzApplicationGatewayUrlPathMapConfig om de configuratie-instellingen en de nieuwe padregel in die instellingen toe te voegen aan ContosoApplicationGateway.

Voorbeeld 2

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

Met deze opdracht maakt u een padregel met de naam 'base', Paden als '/base', BackendAddressPool als $AddressPool, BackendHttpSettings als $HttpSettings en FirewallPolicy als $firewallPolicy.ngs en de nieuwe padregel in die instellingen voor ContosoApplicationGateway.

Parameters

-BackendAddressPool

Hiermee geeft u een objectverwijzing naar een verzameling instellingen voor back-endadresgroepen die moeten worden toegevoegd aan de configuratie-instellingen voor gatewaypadregels. U kunt deze objectverwijzing maken met behulp van de cmdlet New-AzApplicationGatewayBackendAddressPool en syntaxis die vergelijkbaar is met: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Met de voorgaande opdracht worden twee IP-adressen (192.16.1.1 en 192.168.1.2) toegevoegd aan de adresgroep. Het IP-adres wordt tussen aanhalingstekens geplaatst en gescheiden door komma's. De resulterende variabele, $AddressPool, kan vervolgens worden gebruikt als parameterwaarde voor de parameter DefaultBackendAddressPool . De back-endadresgroep vertegenwoordigt de IP-adressen op de back-endservers. Deze IP-adressen moeten deel uitmaken van het subnet van het virtuele netwerk of openbare IP-adressen zijn. Als u deze parameter gebruikt, kunt u de parameter DefaultBackendAddressPoolId niet gebruiken in dezelfde opdracht.

Type:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BackendAddressPoolId

Hiermee geeft u de id op van een bestaande back-endadresgroep die kan worden toegevoegd aan de configuratie-instellingen van de gatewaypadregel. Adresgroep-id's kunnen worden geretourneerd met behulp van de cmdlet Get-AzApplicationGatewayBackendAddressPool. Nadat u de id hebt, kunt u de parameter DefaultBackendAddressPoolId gebruiken in plaats van de parameter DefaultBackendAddressPool . Bijvoorbeeld: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPools" De back-endadresgroep vertegenwoordigt de IP-adressen op de back-endservers. Deze IP-adressen moeten deel uitmaken van het subnet van het virtuele netwerk of openbare IP-adressen zijn.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BackendHttpSettings

Hiermee geeft u een objectverwijzing naar een verzameling back-end HTTP-instellingen die moeten worden toegevoegd aan de configuratie-instellingen van de gatewaypadregel. U kunt deze objectverwijzing maken met behulp van de cmdlet New-AzApplicationGatewayBackendHttpSettings en syntaxis die vergelijkbaar is met: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" De resulterende variabele, $HttpSettings, kan vervolgens worden gebruikt als de parameterwaarde voor de DefaultBackendAddressPool parameter: -DefaultBackendHttpSettings $HttpSettings De back-end HTTP-instellingen configureren eigenschappen zoals poort, protocol en op cookies gebaseerde affiniteit voor een back-endpool. Als u deze parameter gebruikt, kunt u de parameter DefaultBackendHttpSettingsId niet gebruiken in dezelfde opdracht.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BackendHttpSettingsId

Hiermee geeft u de id op van een bestaande verzameling HTTP-instellingen voor de back-end die kan worden toegevoegd aan de configuratie-instellingen van de gatewaypadregel. HTTP-instelling-id's kunnen worden geretourneerd met behulp van de cmdlet Get-AzApplicationGatewayBackendHttpSettings. Nadat u de id hebt, kunt u de parameter DefaultBackendHttpSettingsId gebruiken in plaats van de parameter DefaultBackendHttpSettings . Bijvoorbeeld: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" De back-end HTTP-instellingen configureren eigenschappen zoals poort, protocol en op cookies gebaseerde affiniteit voor een back-endpool. Als u deze parameter gebruikt, kunt u de parameter DefaultBackendHttpSettings niet gebruiken in dezelfde opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FirewallPolicy

Hiermee geeft u de objectverwijzing naar een firewallbeleid op het hoogste niveau. De objectverwijzing kan worden gemaakt met behulp van de cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Een firewallbeleid dat is gemaakt met behulp van de bovenstaande commandlet, kan worden verwezen op padregelniveau. hij boven de opdracht zou een standaardbeleidsinstellingen en beheerde regels maken. In plaats van de standaardwaarden kunnen gebruikers PolicySettings, ManagedRules opgeven met behulp van New-AzApplicationGatewayFirewallPolicySettings en New-AzApplicationGatewayFirewallPolicyManagedRules.

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FirewallPolicyId

Hiermee geeft u de id op van een bestaande web application firewall-resource op het hoogste niveau. Firewallbeleid-id's kunnen worden geretourneerd met behulp van de cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Nadat we de id hebben, kunt u de parameter FirewallPolicyId gebruiken in plaats van de parameter FirewallPolicy. Bijvoorbeeld: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de padregelconfiguratie die door deze cmdlet wordt gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Paths

Hiermee geeft u een of meer padregels voor de toepassingsgateway op.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Type:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RedirectConfigurationId

Id van de redirectConfiguration van de toepassingsgateway

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Type:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RewriteRuleSetId

Id van de toepassingsgateway RewriteRuleSet

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

PSApplicationGatewayPathRule