Udostępnij za pośrednictwem

New-AzApplicationGatewayPathRuleConfig

  • Odwołanie
Moduł:
Az.Network

Tworzy regułę ścieżki bramy aplikacji.

Składnia

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>]

Opis

Polecenie cmdlet New-AzApplicationGatewayPathRuleConfig tworzy regułę ścieżki bramy aplikacji. Reguły utworzone przez to polecenie cmdlet można dodać do kolekcji ustawień konfiguracji mapy ścieżek URL, a następnie przypisanych do bramy. Ustawienia konfiguracji mapy ścieżki są używane w równoważeniu obciążenia bramy aplikacji.

Przykłady

Przykład 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

Te polecenia tworzą nową regułę ścieżki bramy aplikacji, a następnie używają polecenia cmdlet Add-AzApplicationGatewayUrlPathMapConfig , aby przypisać regułę do bramy aplikacji. W tym celu pierwsze polecenie tworzy odwołanie do obiektu bramy ContosoApplicationGateway. Odwołanie do tego obiektu jest przechowywane w zmiennej o nazwie $Gateway. Dwa następne polecenia tworzą pulę adresów zaplecza i obiekt ustawień HTTP zaplecza; te obiekty (przechowywane w zmiennych $AddressPool i $HttpSettings) są potrzebne do utworzenia obiektu reguły ścieżki. Czwarte polecenie tworzy obiekt reguły ścieżki i jest przechowywany w zmiennej o nazwie $PathRuleConfig. Piąte polecenie używa polecenia Add-AzApplicationGatewayUrlPathMapConfig , aby dodać ustawienia konfiguracji i nową regułę ścieżki zawartą w tych ustawieniach do aplikacji ContosoApplicationGateway.

Przykład 2

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

To polecenie tworzy regułę ścieżki o nazwie jako "base", Path as "/base", BackendAddressPool as $AddressPool, BackendHttpSettings as $HttpSettings i FirewallPolicy as $firewallPolicy.ngs i nowej reguły ścieżki zawartej w tych ustawieniach do ContosoApplicationGateway.

Parametry

-BackendAddressPool

Określa odwołanie do obiektu do kolekcji ustawień puli adresów zaplecza, które mają zostać dodane do ustawień konfiguracji reguł ścieżki bramy. Odwołanie do tego obiektu można utworzyć przy użyciu polecenia cmdlet New-AzApplicationGatewayBackendAddressPool i składni podobnej do następującej: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Poprzednie polecenie dodaje do puli adresów dwa adresy IP (192.16.1.1 i 192.168.1.2). Należy pamiętać, że adres IP jest ujęta w znaki cudzysłowu i oddzielona przecinkami. Wynikowa zmienna, $AddressPool, może być następnie używana jako wartość parametru DefaultBackendAddressPool . Pula adresów zaplecza reprezentuje adresy IP na serwerach zaplecza. Te adresy IP powinny należeć do podsieci sieci wirtualnej lub powinny być publicznymi adresami IP. Jeśli używasz tego parametru, nie możesz użyć parametru DefaultBackendAddressPoolId w tym samym poleceniu.

Typ:PSApplicationGatewayBackendAddressPool
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BackendAddressPoolId

Określa identyfikator istniejącej puli adresów zaplecza, którą można dodać do ustawień konfiguracji reguły ścieżki bramy. Identyfikatory puli adresów można zwrócić przy użyciu polecenia cmdlet Get-AzApplicationGatewayBackendAddressPool. Po identyfikatorze możesz użyć parametru DefaultBackendAddressPoolId zamiast parametru DefaultBackendAddressPool . Na przykład: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10// resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Pula adresów zaplecza reprezentuje adresy IP na serwerach zaplecza. Te adresy IP powinny należeć do podsieci sieci wirtualnej lub powinny być publicznymi adresami IP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BackendHttpSettings

Określa odwołanie do obiektu do kolekcji ustawień HTTP zaplecza, które mają zostać dodane do ustawień konfiguracji reguły ścieżki bramy. Odwołanie do tego obiektu można utworzyć przy użyciu polecenia cmdlet New-AzApplicationGatewayBackendHttpSettings i składni podobnej do następującej: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Zmienna wynikowa, $HttpSettings, można następnie użyć jako wartości parametru defaultBackendAddressPool parametr: -DefaultBackendHttpSettings $HttpSettings Ustawienia HTTP zaplecza konfigurują właściwości, takie jak koligacja portów, protokołów i plików cookie dla puli zaplecza. Jeśli używasz tego parametru, nie możesz użyć parametru DefaultBackendHttpSettingsId w tym samym poleceniu.

Typ:PSApplicationGatewayBackendHttpSettings
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BackendHttpSettingsId

Określa identyfikator istniejącej kolekcji ustawień HTTP zaplecza, którą można dodać do ustawień konfiguracji reguły ścieżki bramy. Identyfikatory ustawień HTTP można zwrócić przy użyciu polecenia cmdlet Get-AzApplicationGatewayBackendHttpSettings. Po identyfikatorze możesz użyć parametru DefaultBackendHttpSettingsId zamiast parametru DefaultBackendHttpSettings . Na przykład: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Ustawienia zaplecza, takie jak port, protokół i koligacja oparta na plikach cookie dla puli zaplecza. Jeśli używasz tego parametru, nie możesz użyć parametru DefaultBackendHttpSettings w tym samym poleceniu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FirewallPolicy

Określa odwołanie do obiektu do zasad zapory najwyższego poziomu. Odwołanie do obiektu można utworzyć za pomocą polecenia cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Zasady zapory utworzone przy użyciu powyższego polecenia można odwoływać na poziomie ścieżki-reguły. powyższe polecenie tworzy domyślne ustawienia zasad i zarządzane reguły. Zamiast wartości domyślnych użytkownicy mogą określić wartości PolicySettings, ManagedRules przy użyciu odpowiednio polecenia New-AzApplicationGatewayFirewallPolicySettings i New-AzApplicationGatewayFirewallPolicyManagedRules.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FirewallPolicyId

Określa identyfikator istniejącego zasobu zapory aplikacji internetowej najwyższego poziomu. Identyfikatory zasad zapory można zwrócić przy użyciu polecenia cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Po wprowadzeniu identyfikatora można użyć parametru FirewallPolicyId zamiast parametru FirewallPolicyId. Na przykład: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę konfiguracji reguły ścieżki tworzonej przez to polecenie cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Paths

Określa co najmniej jedną regułę ścieżki bramy aplikacji.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RedirectConfiguration

Przekierowanie bramy aplikacjiKonfiguracja

Typ:PSApplicationGatewayRedirectConfiguration
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RedirectConfigurationId

Identyfikator przekierowania bramy aplikacjiKonfiguracja

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Typ:PSApplicationGatewayRewriteRuleSet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RewriteRuleSetId

Identyfikator rewriteRuleSet bramy aplikacji

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

PSApplicationGatewayPathRule