Share via

New-AzureRmApplicationGatewayPathRuleConfig

  • Reference
Modul:
AzureRM.Network

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

Upozorňující

Modul AzureRM PowerShell byl 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.

Syntax

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 $Http Nastavení) 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.

Type:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzureRmApplicationGatewayBackendHttp Nastavení podobné této: $Http Nastavení = New-AzureRmApplicationGatewayBackendHttp Nastavení -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Výsledná proměnná $Http Nastavení, lze pak použít jako hodnotu parametru DefaultBackendAddressPool: -DefaultBackendHttp Nastavení $Http Nastavení 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 DefaultBackendHttp Nastavení Id ve stejném příkazu.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzureRmApplicationGatewayBackendHttp Nastavení. Jakmile budete mít ID, můžete místo parametru DefaultBackendHttp Nastavení Id použít parametr DefaultBackendHttp Nastavení. Například: -DefaultBackend Nastavení ID /subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Nastavení Collection/ContosoHttp Nastavení" 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 defaultBackendHttp Nastavení parametr ve stejném příkazu.

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

-DefaultProfile

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

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

-Name

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

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

-Paths

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

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

-RedirectConfiguration

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

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

-RedirectConfigurationId

ID služby Application Gateway RedirectConfiguration

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

Vstupy

None

Výstupy

PSApplicationGatewayPathRule