New-AzApplicationGatewayPathRuleConfig

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

Syntax

SetByResourceId

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

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ýsledná proměnná, $AddressPool, se pak dá použít jako hodnota 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.

Vlastnosti parametru

Typ:PSApplicationGatewayBackendAddressPool
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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 se dají 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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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 "Zakázáno" Výsledná proměnná, $HttpSettings je pak možné použít jako hodnotu parametru DefaultBackendAddressPool : -DefaultBackendHttpSettings $HttpSettings 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 DefaultBackendHttpSettingsId ve stejném příkazu.

Vlastnosti parametru

Typ:PSApplicationGatewayBackendHttpSettings
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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 . Napří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í založené na souborech cookie pro back-endový fond. Pokud použijete tento parametr, nemůžete použít parametr DefaultBackendHttpSettings ve stejném příkazu.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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" Zásady brány firewall vytvořené pomocí výše uvedené rutiny 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 můžou uživatelé zadat PolicySettings, ManagedRules pomocí New-AzApplicationGatewayFirewallPolicySettings a New-AzApplicationGatewayFirewallPolicyManagedRules.

Vlastnosti parametru

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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. Například: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Paths

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-RedirectConfiguration

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

Vlastnosti parametru

Typ:PSApplicationGatewayRedirectConfiguration
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-RedirectConfigurationId

ID služby Application Gateway RedirectConfiguration

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-RewriteRuleSet

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

Vlastnosti parametru

Typ:PSApplicationGatewayRewriteRuleSet
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-RewriteRuleSetId

ID sady Application Gateway RewriteRuleSet

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

PSApplicationGatewayPathRule