Share via

New-AzApplicationGatewayPathRuleConfig

  • Referencia
Modul:
Az.Network

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 $Http Gépház 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út-szabályt, amelynek neve "base", paths as "/base", BackendAddressPool as $AddressPool, BackendHttp Gépház as $Http Gépház é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.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Gépház parancsmaggal és a következőhöz hasonló szintaxissal hozhatja létre: $Http Gépház = New-AzApplicationGatewayBackendHttp Gépház -Name "ContosoHttp Gépház" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Az eredményül kapott változó, $Http Gépházezután a DefaultBackendAddressPool paraméter paraméterértékeként használható: -DefaultBackendHttp Gépház $Http Gépház 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 DefaultBackendHttp Gépház Id paramétert ugyanabban a parancsban.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzApplicationGatewayBackendHttp Gépház parancsmaggal adhatók vissza. Az azonosító megadása után a DefaultBackendHttp Gépház Id paramétert használhatja a DefaultBackendHttp Gépház paraméter helyett. Például: -DefaultBackend Gépház Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Gépház Collection/ContosoHttp Gépház" 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 DefaultBackendHttp Gépház paramétert ugyanabban a parancsban.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Policy Gépház, a ManagedRules és a New-AzApplicationGatewayFirewallPolicy Gépház és a New-AzApplicationGatewayFirewallPolicyManagedRules használatával adhatók meg.

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

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

-Name

Megadja a parancsmag által létrehozott elérésiút-szabály konfigurációjának nevét.

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

-Paths

Egy vagy több application gateway elérésiút-szabályt határoz meg.

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

-RedirectConfiguration

Application gateway RedirectConfiguration

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

-RedirectConfigurationId

Az Application Gateway RedirectConfiguration azonosítója

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

Az Application Gateway RewriteRuleSet azonosítója

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

Bevitelek

None

Kimenetek

PSApplicationGatewayPathRule