New-AzApplicationGatewayPathRuleConfig

  • Referens
Modul:
Az.Network

Skapar en sökvägsregel för application gateway.

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

Cmdleten New-AzApplicationGatewayPathRuleConfig skapar en sökvägsregel för application gateway. Regler som skapats av den här cmdleten kan läggas till i en samling konfigurationsinställningar för url-sökvägskarta och sedan tilldelas till en gateway. Konfigurationsinställningar för sökvägskarta används vid belastningsutjämning för application gateway.

Exempel

Exempel 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

Dessa kommandon skapar en ny sökvägsregel för application gateway och använder sedan cmdleten Add-AzApplicationGatewayUrlPathMapConfig för att tilldela den regeln till en programgateway. För att göra detta skapar det första kommandot en objektreferens till gatewayen ContosoApplicationGateway. Den här objektreferensen lagras i en variabel med namnet $Gateway. De följande två kommandona skapar en serverdelsadresspool och ett HTTP-inställningsobjekt för serverdelen. dessa objekt (som lagras i variablerna $AddressPool och $Http Inställningar) behövs för att skapa ett sökvägsregelobjekt. Det fjärde kommandot skapar sökvägsregelobjektet och lagras i en variabel med namnet $PathRuleConfig. Det femte kommandot använder Add-AzApplicationGatewayUrlPathMapConfig för att lägga till konfigurationsinställningarna och den nya sökvägsregeln som finns i inställningarna i ContosoApplicationGateway.

Exempel 2

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

Det här kommandot skapar en sökvägsregel med Namnet som "bas", Sökvägar som "/base", BackendAddressPool som $AddressPool, BackendHttp Inställningar som $Http Inställningar och FirewallPolicy som $firewallPolicy.ngs och den nya sökvägsregeln som finns i dessa inställningar till ContosoApplicationGateway.

Parametrar

-BackendAddressPool

Anger en objektreferens till en samling inställningar för serverdelsadresspoolen som ska läggas till i konfigurationsinställningarna för gatewaysökvägsregler. Du kan skapa den här objektreferensen med hjälp av cmdleten New-AzApplicationGatewayBackendAddressPool och syntax som liknar följande: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Föregående kommando lägger till två IP-adresser (192.16.1.1 och 192.168.1.2) till adresspoolen. Observera att IP-adressen omges av citattecken och avgränsas med kommatecken. Den resulterande variabeln $AddressPool kan sedan användas som parametervärde för parametern DefaultBackendAddressPool . Serverdelsadresspoolen representerar IP-adresserna på serverdelsservrarna. Dessa IP-adresser ska antingen tillhöra undernätet för det virtuella nätverket eller vara offentliga IP-adresser. Om du använder den här parametern kan du inte använda parametern DefaultBackendAddressPoolId i samma kommando.

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

-BackendAddressPoolId

Anger ID för en befintlig serverdelsadresspool som kan läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. Adresspools-ID:t kan returneras med hjälp av cmdleten Get-AzApplicationGatewayBackendAddressPool. När du har ID:t kan du sedan använda parametern DefaultBackendAddressPoolId i stället för parametern DefaultBackendAddressPool . Till exempel: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Serverdelsadresspoolen representerar IP-adresserna på serverdelsservrarna. Dessa IP-adresser ska antingen tillhöra undernätet för det virtuella nätverket eller vara offentliga IP-adresser.

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

-BackendHttpSettings

Anger en objektreferens till en samling HTTP-inställningar för serverdelen som ska läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. Du kan skapa den här objektreferensen med hjälp av cmdleten New-AzApplicationGatewayBackendHttp Inställningar och syntax som liknar följande: $Http Inställningar = New-AzApplicationGatewayBackendHttp Inställningar -Name "ContosoHttp Inställningar" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Den resulterande variabeln $HttpInställningar kan sedan användas som parametervärde för Parametern DefaultBackendAddressPool: -DefaultBackendHttp Inställningar $Http Inställningar HTTP-inställningarna för serverdelen konfigurerar egenskaper som port, protokoll och cookiebaserad tillhörighet för en serverdelspool. Om du använder den här parametern kan du inte använda parametern DefaultBackendHttp Inställningar Id i samma kommando.

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

-BackendHttpSettingsId

Anger ID:t för en befintlig HTTP-inställningssamling för serverdelen som kan läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. HTTP-inställnings-ID:er kan returneras med hjälp av cmdleten Get-AzApplicationGatewayBackendHttp Inställningar. När du har ID:t kan du sedan använda parametern DefaultBackendHttp Inställningar Id i stället för parametern DefaultBackendHttp Inställningar. Till exempel: -DefaultBackend Inställningar ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Inställningar Collection/ContosoHttp Inställningar" Http-inställningarna för serverdelen konfigurerar egenskaper som port, protokoll, och cookiebaserad tillhörighet för en serverdelspool. Om du använder den här parametern kan du inte använda parametern DefaultBackendHttp Inställningar i samma kommando.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

Anger objektreferensen till en brandväggsprincip på den översta nivån. Objektreferensen kan skapas med hjälp av cmdleten New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" En brandväggsprincip som skapats med kommandot ovan kan refereras på sökvägsregelnivå. han ovan kommandot skulle skapa en standard principinställningar och hanterade regler. I stället för standardvärdena kan användarna ange Princip Inställningar, ManagedRules med hjälp av New-AzApplicationGatewayFirewallPolicy Inställningar respektive New-AzApplicationGatewayFirewallPolicyManagedRules.

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

-FirewallPolicyId

Anger ID för en befintlig brandväggsresurs för webbprogram på toppnivå. Brandväggsprincip-ID:t kan returneras med hjälp av cmdleten Get-AzApplicationGatewayWebApplicationFirewallPolicy. När vi har ID:t kan du använda parametern FirewallPolicyId i stället för parametern FirewallPolicy . Till exempel: -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

Anger namnet på den konfiguration av sökvägsregeln som den här cmdleten skapar.

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

-Paths

Anger en eller flera sökvägsregler för programgatewayen.

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

-RedirectConfiguration

Omdirigering av ProgramgatewayKonfiguration

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

-RedirectConfigurationId

ID för programgatewayen 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 för application gateway RewriteRuleSet

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

Indata

None

Utdata

PSApplicationGatewayPathRule