Udostępnij przez

New-AzApplicationGatewayPathRuleConfig

Moduł:
Az.Network Module

Tworzy regułę ścieżki bramy aplikacji.

Składnia

SetByResourceId 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

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.

Właściwości parametrów

Typ:PSApplicationGatewayBackendAddressPool
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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" Wynikowa zmienna, $HttpSettings można następnie użyć jako wartości parametru parametru DefaultBackendAddressPool : -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.

Właściwości parametrów

Typ:PSApplicationGatewayBackendHttpSettings
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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: identyfikator -DefaultBackendSettings "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" 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 DefaultBackendHttpSettings w tym samym poleceniu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-FirewallPolicy

Określa odwołanie do obiektu do zasad zapory najwyższego poziomu. Odwołanie do obiektu można utworzyć przy użyciu polecenia cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Zasady zapory utworzone przy użyciu powyższego polecenia cmdlet można odwoływać się na poziomie reguły ścieżki. 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 New-AzApplicationGatewayFirewallPolicySettings i New-AzApplicationGatewayFirewallPolicyManagedRules.

Właściwości parametrów

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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>

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Name

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Paths

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

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RedirectConfiguration

Przekierowanie bramy aplikacjiKonfiguracja

Właściwości parametrów

Typ:PSApplicationGatewayRedirectConfiguration
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RedirectConfigurationId

Identyfikator przekierowania bramy aplikacjiKonfiguracja

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Właściwości parametrów

Typ:PSApplicationGatewayRewriteRuleSet
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RewriteRuleSetId

Identyfikator rewriteRuleSet bramy aplikacji

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

None

Wyjść

PSApplicationGatewayPathRule