New-AzApplicationGatewayPathRuleConfig

  • Referentie
Module:
Az.Network

Hiermee maakt u een padregel voor de toepassingsgateway.

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

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 $Http Instellingen) 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, BackendHttp Instellingen als $Http Instellingen 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Instellingen en syntaxis die er ongeveer als volgt uitzien: $Http Instellingen = New-AzApplicationGatewayBackendHttp Instellingen -Name "ContosoHttp Instellingen" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" De resulterende variabele $HttpInstellingen kan vervolgens worden gebruikt als de parameterwaarde voor de De parameter DefaultBackendAddressPool: -DefaultBackendHttp Instellingen $Http Instellingen De back-end-HTTP-instellingen configureren eigenschappen zoals poort, protocol en affiniteit op basis van cookies voor een back-endpool. Als u deze parameter gebruikt, kunt u de parameter DefaultBackendHttp Instellingen Id niet gebruiken in dezelfde opdracht.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Instellingen. Nadat u de id hebt, kunt u de parameter DefaultBackendHttp Instellingen Id gebruiken in plaats van de parameter DefaultBackendHttp Instellingen. Bijvoorbeeld: -DefaultBackend Instellingen Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10 /resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Instellingen Collection/ContosoHttp Instellingen" De back-end HTTP-instellingen configureren eigenschappen zoals poort, protocol, en affiniteit op basis van cookies voor een back-endpool. Als u deze parameter gebruikt, kunt u de parameter DefaultBackendHttp Instellingen niet gebruiken in dezelfde opdracht.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Beleid Instellingen, ManagedRules opgeven met behulp van New-AzApplicationGatewayFirewallPolicy Instellingen en New-AzApplicationGatewayFirewallPolicyManagedRules.

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

-Name

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

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

-Paths

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

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 van de redirectConfiguration van de toepassingsgateway

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 van de toepassingsgateway RewriteRuleSet

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

Invoerwaarden

None

Uitvoerwaarden

PSApplicationGatewayPathRule