Sdílet prostřednictvím

New-AzApplicationGatewayPathRuleConfig

  • Reference
Modul:
Az.Network

Vytvoří pravidlo cesty ke službě Application Gateway.

Syntaxe

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

Rutina New-AzApplicationGatewayPathRuleConfig vytvoří pravidlo cesty aplikační brány. Pravidla vytvořená touto rutinou je možné přidat do kolekce nastavení konfigurace mapy cest URL a pak je přiřadit k bráně. Nastavení konfigurace mapy cest se používají při vyrovnávání zatížení služby Application Gateway.

Příklady

Příklad 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

Tyto příkazy vytvoří nové pravidlo cesty ke službě Application Gateway a pak pomocí rutiny Add-AzApplicationGatewayUrlPathMapConfig toto pravidlo přiřadí ke službě Application Gateway. Uděláte to tak, že první příkaz vytvoří odkaz na objekt brány ContosoApplicationGateway. Tento odkaz na objekt je uložen v proměnné s názvem $Gateway. Následující dva příkazy vytvoří back-endový fond adres a objekt nastavení HTTP back-endu; tyto objekty (uložené v proměnných $AddressPool a $HttpSettings) jsou potřeba k vytvoření objektu pravidla cesty. Čtvrtý příkaz vytvoří objekt pravidla cesty a uloží se do proměnné s názvem $PathRuleConfig. Pátý příkaz používá Add-AzApplicationGatewayUrlPathMapConfig k přidání nastavení konfigurace a nového pravidla cesty obsaženého v těchto nastaveních do ContosoApplicationGateway.

Příklad 2

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

Tento příkaz vytvoří pravidlo cesty s názvem jako "base", Cesty jako "/base", BackendAddressPool jako $AddressPool, BackendHttpSettings jako $HttpSettings a FirewallPolicy jako $firewallPolicy.ngs a nové pravidlo cesty obsažené v těchto nastaveních contosoApplicationGateway.

Parametry

-BackendAddressPool

Určuje odkaz na objekt na kolekci nastavení back-endového fondu adres, která se mají přidat do nastavení konfigurace pravidel cesty brány. Tento odkaz na objekt můžete vytvořit pomocí rutiny New-AzApplicationGatewayBackendAddressPool a syntaxe podobné této: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Předchozí příkaz přidá do fondu adres dvě IP adresy (192.16.1.1 a 192.168.1.2). Všimněte si, že IP adresa je uzavřená v uvozovkách a oddělená čárkami. Výslednou proměnnou, $AddressPool, pak lze použít jako hodnotu parametru DefaultBackendAddressPool . Fond back-endových adres představuje IP adresy na back-endových serverech. Tyto IP adresy by měly patřit buď do podsítě virtuální sítě, nebo by měly být veřejné IP adresy. Pokud použijete tento parametr, nelze použít DefaultBackendAddressPoolId parametr ve stejném příkazu.

Typ:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BackendAddressPoolId

Určuje ID existujícího back-endového fondu adres, který lze přidat do nastavení konfigurace pravidla cesty brány. ID fondu adres je možné vrátit pomocí rutiny Get-AzApplicationGatewayBackendAddressPool. Jakmile budete mít ID, můžete použít DefaultBackendAddressPoolId parametr místo DefaultBackendAddressPool parametr. Například: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/ resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Back-endový fond adres představuje IP adresy na back-endových serverech. Tyto IP adresy by měly patřit buď do podsítě virtuální sítě, nebo by měly být veřejné IP adresy.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BackendHttpSettings

Určuje odkaz na objekt na kolekci nastavení HTTP back-endu, která se má přidat do nastavení konfigurace pravidla cesty brány. Tento odkaz na objekt můžete vytvořit pomocí rutiny New-AzApplicationGatewayBackendHttpSettings a syntaxe podobné této: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Výsledná proměnná, $HttpSettings, pak lze použít jako hodnotu parametru Pro DefaultBackendAddressPool . parametr: -DefaultBackendHttpSettings $HttpSettings Nastavení HTTP back-endu konfiguruje vlastnosti, jako je port, protokol a spřažení na základě souborů cookie pro back-endový fond. Pokud použijete tento parametr, nemůžete použít parametr DefaultBackendHttpSettingsId ve stejném příkazu.

Typ:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BackendHttpSettingsId

Určuje ID existující kolekce nastavení HTTP back-endu, kterou lze přidat do nastavení konfigurace pravidla cesty brány. ID nastavení HTTP je možné vrátit pomocí rutiny Get-AzApplicationGatewayBackendHttpSettings. Jakmile budete mít ID, můžete místo parametru DefaultBackendHttpSettingsId použít defaultBackendHttpSettings. Příklad: -DefaultBackendSettings ID /subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Nastavení back-endu HTTP konfiguruje vlastnosti, jako je port, protokol a spřažení na základě souborů cookie pro back-endový fond. Pokud použijete tento parametr, nemůžete použít parametr DefaultBackendHttpSettings ve stejném příkazu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FirewallPolicy

Určuje odkaz na objekt na zásady brány firewall nejvyšší úrovně. Odkaz na objekt lze vytvořit pomocí rutiny New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" A zásadu brány firewall vytvořenou pomocí výše uvedeného příkazu lze odkazovat na úroveň pravidla cesty. výše uvedený příkaz vytvoří výchozí nastavení zásad a spravovaná pravidla. Místo výchozích hodnot mohou uživatelé zadat PolicySettings, ManagedRules pomocí Rutiny New-AzApplicationGatewayFirewallPolicySettings a New-AzApplicationGatewayFirewallPolicyManagedRules.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FirewallPolicyId

Určuje ID existujícího prostředku firewallu webových aplikací nejvyšší úrovně. ID zásad brány firewall je možné vrátit pomocí rutiny Get-AzApplicationGatewayWebApplicationFirewallPolicy. Jakmile máme ID, můžete místo parametru FirewallPolicyId použít parametr FirewallPolicyId. Příklad: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název konfigurace pravidla cesty, kterou tato rutina vytvoří.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Paths

Určuje jedno nebo více pravidel cesty ke službě Application Gateway.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RedirectConfiguration

Konfigurace přesměrování služby Application Gateway

Typ:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RedirectConfigurationId

ID služby Application Gateway RedirectConfiguration

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RewriteRuleSet

Přepsání sadyRuleSet ve službě Application Gateway

Typ:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RewriteRuleSetId

ID sady Application Gateway RewriteRuleSet

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

PSApplicationGatewayPathRule