New-AzApplicationGatewayPathRuleConfig
Létrehoz egy Application Gateway elérési útszabályt.
Syntax
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>]
Description
A New-AzApplicationGatewayPathRuleConfig parancsmag létrehoz egy application gateway path szabályt. A parancsmag által létrehozott szabályok hozzáadhatók az URL-útvonaltérkép konfigurációs beállításainak gyűjteményéhez, majd hozzárendelhetők egy átjáróhoz. Az útvonaltérkép konfigurációs beállításait az Application Gateway terheléselosztása használja.
Példák
1. példa
$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
Ezek a parancsok létrehoznak egy új Application Gateway-elérési szabályt, majd az Add-AzApplicationGatewayUrlPathMapConfig parancsmaggal rendelik hozzá a szabályt egy alkalmazásátjáróhoz. Ehhez az első parancs létrehoz egy objektumhivatkozást a ContosoApplicationGateway átjáróra. Ez az objektumhivatkozás egy $Gateway nevű változóban van tárolva. A következő két parancs létrehoz egy háttércímkészletet és egy háttérbeli HTTP-beállításobjektumot; Ezekre az objektumokra ($AddressPool és $HttpSettings változókban) szükség van egy elérésiút-szabályobjektum létrehozásához. A negyedik parancs létrehozza az elérési útszabály-objektumot, és egy $PathRuleConfig nevű változóban tárolja. Az ötödik parancs az Add-AzApplicationGatewayUrlPathMapConfig használatával adja hozzá a beállításokban található konfigurációs beállításokat és az új elérési utat a ContosoApplicationGatewayhez.
2. példa
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy
Ezek a parancsok létrehoznak egy elérési utat tartalmazó szabályt, amelynek neve "base", paths as "/base", BackendAddressPool as $AddressPool, BackendHttpSettings as $HttpSettings és FirewallPolicy as $firewallPolicy.ngs, valamint a ContosoApplicationGateway beállításai között található új elérésiút-szabály.
Paraméterek
-BackendAddressPool
Az átjáró elérési útjának konfigurációs beállításaihoz hozzáadandó háttércímkészlet-beállítások gyűjteményére mutató objektumhivatkozást ad meg.
Ezt az objektumhivatkozást a New-AzApplicationGatewayBackendAddressPool parancsmaggal és a következőhöz hasonló szintaxissal hozhatja létre: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
Az előző parancs két IP-címet (192.16.1.1 és 192.168.1.2) ad hozzá a címkészlethez.
Vegye figyelembe, hogy az IP-cím idézőjelek közé van állítva, és vesszővel van elválasztva.
Az eredményül kapott változó ($AddressPool) ezután használható a DefaultBackendAddressPool paraméter paraméterértékeként.
A háttércímkészlet a háttérkiszolgálók IP-címeit jelöli.
Ezeknek az IP-címeknek vagy a virtuális hálózati alhálózathoz kell tartoznia, vagy nyilvános IP-címeknek kell lenniük.
Ha ezt a paramétert használja, nem használhatja a DefaultBackendAddressPoolId paramétert ugyanabban a parancsban.
Típus: | PSApplicationGatewayBackendAddressPool |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-BackendAddressPoolId
Megadja egy meglévő háttércímkészlet azonosítóját, amely hozzáadható az átjáró elérési útjának konfigurációs beállításaihoz. A címkészlet azonosítóit a Get-AzApplicationGatewayBackendAddressPool parancsmaggal lehet visszaadni. Az azonosító megadása után a DefaultBackendAddressPoolId paramétert használhatja a DefaultBackendAddressPool paraméter helyett. Például: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" A háttércímkészlet a háttérkiszolgálók IP-címeit jelöli. Ezeknek az IP-címeknek vagy a virtuális hálózati alhálózathoz kell tartoznia, vagy nyilvános IP-címeknek kell lenniük.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-BackendHttpSettings
Az átjáró elérési útjának konfigurációs beállításaihoz hozzáadandó háttérbeli HTTP-beállítások gyűjteményére mutató objektumhivatkozást ad meg. Ezt az objektumhivatkozást a New-AzApplicationGatewayBackendHttpSettings parancsmaggal és a következőhöz hasonló szintaxissal hozhatja létre: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Az eredményül kapott változó, $HttpSettings ezután a DefaultBackendAddressPool paraméterértékeként használható paraméter: -DefaultBackendHttpSettings $HttpSettings A háttérbeli HTTP-beállítások olyan tulajdonságokat konfigurálnak, mint a port, a protokoll és a cookie-alapú affinitás egy háttérkészlethez. Ha ezt a paramétert használja, nem használhatja a DefaultBackendHttpSettingsId paramétert ugyanabban a parancsban.
Típus: | PSApplicationGatewayBackendHttpSettings |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-BackendHttpSettingsId
Megadja egy meglévő háttérbeli HTTP-beállításcsoport azonosítóját, amely hozzáadható az átjáró elérési útjának konfigurációs beállításaihoz. A HTTP-beállításazonosítók a Get-AzApplicationGatewayBackendHttpSettings parancsmaggal adhatók vissza. Az azonosító megadása után a DefaultBackendHttpSettingsId paramétert használhatja a DefaultBackendHttpSettings paraméter helyett. Például: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" A háttérBELI HTTP-beállítások olyan tulajdonságokat konfigurálnak, mint a port, a protokoll, a és egy háttérkészlet cookie-alapú affinitása. Ha ezt a paramétert használja, nem használhatja a DefaultBackendHttpSettings paramétert ugyanabban a parancsban.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-FirewallPolicy
Egy legfelső szintű tűzfalszabályzat objektumhivatkozását adja meg. Az objektumhivatkozás a New-AzApplicationGatewayWebApplicationFirewallPolicy parancsmaggal hozható létre. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" A fenti parancsmag használatával létrehozott tűzfalszabály elérésiút-szabály szintjén hivatkozható. a fenti parancs létrehozna egy alapértelmezett házirend-beállításokat és felügyelt szabályokat. Az alapértelmezett értékek helyett a felhasználók a New-AzApplicationGatewayFirewallPolicySettings és a New-AzApplicationGatewayFirewallPolicyManagedRules használatával adhatják meg a PolicySettings és a ManagedRules értéket.
Típus: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-FirewallPolicyId
Egy meglévő legfelső szintű webalkalmazás tűzfalerőforrásának azonosítóját adja meg.
A tűzfalszabályzat azonosítóit a Get-AzApplicationGatewayWebApplicationFirewallPolicy parancsmaggal lehet visszaadni.
Az azonosító megadása után a FirewallPolicy paraméter helyett a FirewallPolicyId paramétert használhatja.
Például: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a parancsmag által létrehozott elérésiút-szabály konfigurációjának nevét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Paths
Egy vagy több application gateway elérésiút-szabályt határoz meg.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RedirectConfiguration
Application gateway RedirectConfiguration
Típus: | PSApplicationGatewayRedirectConfiguration |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RedirectConfigurationId
Az Application Gateway RedirectConfiguration azonosítója
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RewriteRuleSet
Application gateway RewriteRuleSet
Típus: | PSApplicationGatewayRewriteRuleSet |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RewriteRuleSetId
Az Application Gateway RewriteRuleSet azonosítója
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Kimenetek
Kapcsolódó hivatkozások
- Add-AzApplicationGatewayUrlPathMapConfig
- Get-AzApplicationGateway
- Get-AzApplicationGatewayUrlPathMapConfig
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayPathRuleConfig
- New-AzApplicationGatewayUrlPathMapConfig
- Remove-AzApplicationGatewayUrlPathMapConfig
- Set-AzApplicationGatewayUrlPathMapConfig