New-AzureRmApplicationGatewayPathRuleConfig

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

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RedirectConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Rutina New-AzureRmApplicationGatewayPathRuleConfig vytvoří pravidlo cesty ke službě Application Gateway. 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

PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

Tyto příkazy vytvoří nové pravidlo cesty služby Application Gateway a pak toto pravidlo přiřadí aplikační bráně pomocí rutiny Add-AzureRmApplicationGatewayUrlPathMapConfig . 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-AzureRmApplicationGatewayUrlPathMapConfig k přidání nastavení konfigurace a nového pravidla cesty obsaženého v těchto nastaveních do 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. Odkaz na tento objekt můžete vytvořit pomocí rutiny New-AzureRmApplicationGatewayBackendAddressPool a syntaxe podobné této: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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-AzureRmApplicationGatewayBackendAddressPool. 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-AzureRmApplicationGatewayBackendHttpSettings a syntaxe podobné této: $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Výsledná proměnná, $HttpSettings, pak se dá použít jako hodnota 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-AzureRmApplicationGatewayBackendHttpSettings. 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:AzureRmContext, AzureCredential
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:List<T>[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

Vstupy

None

Výstupy

PSApplicationGatewayPathRule