Udostępnij za pośrednictwem

New-AzureRmApplicationGatewayPathRuleConfig

  • Odwołanie
Moduł:
AzureRM.Network

Tworzy regułę ścieżki bramy aplikacji.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet New-AzureRmApplicationGatewayPathRuleConfig 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

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

Te polecenia tworzą nową regułę ścieżki bramy aplikacji, a następnie używają polecenia cmdlet Add-AzureRmApplicationGatewayUrlPathMapConfig , 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-AzureRmApplicationGatewayUrlPathMapConfig , aby dodać ustawienia konfiguracji i nową regułę ścieżki zawartą w tych ustawieniach do aplikacji 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-AzureRmApplicationGatewayBackendAddressPool i składni podobnej do następującej: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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-AzureRmApplicationGatewayBackendAddressPool. 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-AzureRmApplicationGatewayBackendHttpSettings i składni podobnej do następującej: $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -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-AzureRmApplicationGatewayBackendHttpSettings. 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:AzureRmContext, AzureCredential
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:List<T>[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

Dane wejściowe

None

Dane wyjściowe

PSApplicationGatewayPathRule