Udostępnij przez

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 $Http Ustawienia) 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, BackendHttp Ustawienia as $Http Ustawienia 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.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Ustawienia i składni podobnej do następującej: $Http Ustawienia = New-AzApplicationGatewayBackendHttp Ustawienia -Name "ContosoHttp Ustawienia" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Wynikowa zmienna $Http Ustawienia, można następnie użyć jako wartości parametru parametru DefaultBackendAddressPool: -DefaultBackendHttp Ustawienia $Http Ustawienia 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 DefaultBackendHttp Ustawienia Id w tym samym poleceniu.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Ustawienia. Po identyfikatorze możesz użyć parametru DefaultBackendHttp Ustawienia Id zamiast parametru DefaultBackendHttp Ustawienia. Na przykład: -DefaultBackend Ustawienia Identyfikator "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Ustawienia Collection/ContosoHttp Ustawienia" Ustawienia HTTP zaplecza konfigurują właściwości, 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 DefaultBackendHttp Ustawienia w tym samym poleceniu.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ć zasady Ustawienia, ManagedRules przy użyciu odpowiednio polecenia New-AzApplicationGatewayFirewallPolicy Ustawienia i New-AzApplicationGatewayFirewallPolicyManagedRules.

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

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

-Name

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

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

-Paths

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

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

-RedirectConfiguration

Przekierowanie bramy aplikacjiKonfiguracja

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

-RedirectConfigurationId

Identyfikator przekierowania bramy aplikacjiKonfiguracja

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

-RewriteRuleSet

Application gateway RewriteRuleSet

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

-RewriteRuleSetId

Identyfikator rewriteRuleSet bramy aplikacji

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

Dane wejściowe

None

Dane wyjściowe

PSApplicationGatewayPathRule