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
Související odkazy
- Add-AzureRmApplicationGatewayUrlPathMapConfig
- Get-AzureRmApplicationGateway
- Get-AzureRmApplicationGatewayUrlPathMapConfig
- New-AzureRmApplicationGatewayBackendAddressPool
- New-AzureRmApplicationGatewayBackendHttpSettings
- New-AzureRmApplicationGatewayPathRuleConfig
- New-AzureRmApplicationGatewayUrlPathMapConfig
- Remove-AzureRmApplicationGatewayUrlPathMapConfig
- Set-AzureRmApplicationGatewayUrlPathMapConfig