New-AzApplicationGatewayPathRuleConfig
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 programgateway 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 $HttpSettings) 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 i dessa inställningar till 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, BackendHttpSettings som $HttpSettings 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 New-AzApplicationGatewayBackendAddressPool-cmdleten och syntaxen 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) i 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.
Typ: | PSApplicationGatewayBackendAddressPool |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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 New-AzApplicationGatewayBackendHttpSettings-cmdleten och syntaxen som liknar följande: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Den resulterande variabeln, $HttpSettings kan sedan användas som parametervärde för parametern DefaultBackendAddressPool parameter: -DefaultBackendHttpSettings $HttpSettings 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 DefaultBackendHttpSettingsId i samma kommando.
Typ: | PSApplicationGatewayBackendHttpSettings |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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-AzApplicationGatewayBackendHttpSettings. När du har ID:t kan du sedan använda parametern DefaultBackendHttpSettingsId i stället för parametern DefaultBackendHttpSettings. Till exempel: -DefaultBackendSettings ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Serverdelens HTTP-inställningar 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 DefaultBackendHttpSettings i samma kommando.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-FirewallPolicy
Anger objektreferensen till en brandväggsprincip på den översta nivån. Objektreferensen kan skapas med hjälp av New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" En brandväggsprincip som skapats med hjälp av 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 PrincipInställningar, ManagedRules med hjälp av New-AzApplicationGatewayFirewallPolicySettings respektive New-AzApplicationGatewayFirewallPolicyManagedRules.
Typ: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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 FirewallPolicy parameter.
Till exempel: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Name
Anger namnet på den konfiguration av sökvägsregeln som den här cmdleten skapar.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Paths
Anger en eller flera sökvägsregler för programgatewayen.
Typ: | String[] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-RedirectConfiguration
Omdirigering av ProgramgatewayKonfiguration
Typ: | PSApplicationGatewayRedirectConfiguration |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-RedirectConfigurationId
ID för programgatewayen RedirectConfiguration
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-RewriteRuleSet
Application gateway RewriteRuleSet
Typ: | PSApplicationGatewayRewriteRuleSet |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-RewriteRuleSetId
ID för application gateway RewriteRuleSet
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Indata
None
Utdata
Relaterade länkar
- Add-AzApplicationGatewayUrlPathMapConfig
- Get-AzApplicationGateway
- Get-AzApplicationGatewayUrlPathMapConfig
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayPathRuleConfig
- New-AzApplicationGatewayUrlPathMapConfig
- Remove-AzApplicationGatewayUrlPathMapConfig
- Set-AzApplicationGatewayUrlPathMapConfig
Azure PowerShell