New-AzApplicationGatewayPathRuleConfig

  • Başvuru
Modül:
Az.Network

Bir uygulama ağ geçidi yol kuralı oluşturur.

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

New-AzApplicationGatewayPathRuleConfig cmdlet'i bir uygulama ağ geçidi yol kuralı oluşturur. Bu cmdlet tarafından oluşturulan kurallar, URL yolu eşleme yapılandırma ayarları koleksiyonuna eklenebilir ve ardından bir ağ geçidine atanabilir. Yol haritası yapılandırma ayarları, uygulama ağ geçidi yük dengelemesinde kullanılır.

Örnekler

Örnek 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

Bu komutlar yeni bir uygulama ağ geçidi yol kuralı oluşturur ve ardından Add-AzApplicationGatewayUrlPathMapConfig cmdlet'ini kullanarak bu kuralı bir uygulama ağ geçidine atar. Bunu yapmak için, ilk komut ContosoApplicationGateway ağ geçidine bir nesne başvurusu oluşturur. Bu nesne başvurusu $Gateway adlı bir değişkende depolanır. Sonraki iki komut bir arka uç adres havuzu ve bir arka uç HTTP ayarları nesnesi oluşturur; bu nesneler ($AddressPool ve $Http Ayarlar değişkenlerinde depolanır) bir yol kuralı nesnesi oluşturmak için gereklidir. Dördüncü komut yol kuralı nesnesini oluşturur ve $PathRuleConfig adlı bir değişkende depolanır. Beşinci komut Add-AzApplicationGatewayUrlPathMapConfig komutunu kullanarak yapılandırma ayarlarını ve bu ayarların içinde yer alan yeni yol kuralını ContosoApplicationGateway'e ekler.

Örnek 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

Bu komut Ad olarak "base", Paths as "/base", BackendAddressPool as $AddressPool, BackendHttp Ayarlar as $Http Ayarlar ve FirewallPolicy as $firewallPolicy.ngs ve contosoApplicationGateway ayarları içinde yer alan yeni yol kuralı ile bir yol kuralı oluşturur.

Parametreler

-BackendAddressPool

Ağ geçidi yol kuralları yapılandırma ayarlarına eklenecek arka uç adres havuzu ayarları koleksiyonuna bir nesne başvurusu belirtir. New-AzApplicationGatewayBackendAddressPool cmdlet'ini ve buna benzer söz dizimini kullanarak bu nesne başvuruyu oluşturabilirsiniz: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Yukarıdaki komut, adres havuzuna iki IP adresi (192.16.1.1 ve 192.168.1.2) ekler. IP adresinin tırnak işaretleri içine alındığını ve virgüller kullanılarak ayrıldığını unutmayın. $AddressPool sonuçta elde edilen değişken, DefaultBackendAddressPool parametresinin parametre değeri olarak kullanılabilir. Arka uç adres havuzu, arka uç sunucularında IP adreslerini temsil eder. Bu IP adresleri sanal ağ alt ağına ait olmalı veya genel IP adresleri olmalıdır. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendAddressPoolId parametresini kullanamazsınız.

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

-BackendAddressPoolId

Ağ geçidi yolu kuralı yapılandırma ayarlarına eklenebilen mevcut bir arka uç adres havuzunun kimliğini belirtir. Adres havuzu kimlikleri Get-AzApplicationGatewayBackendAddressPool cmdlet'i kullanılarak döndürülebilir. Kimliği aldıktan sonra DefaultBackendAddressPool parametresi yerine DefaultBackendAddressPoolId parametresini kullanabilirsiniz. Örneğin: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Arka uç adres havuzu, arka uç sunucularındaki IP adreslerini temsil eder. Bu IP adresleri sanal ağ alt ağına ait olmalı veya genel IP adresleri olmalıdır.

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

-BackendHttpSettings

Ağ geçidi yolu kuralı yapılandırma ayarlarına eklenecek arka uç HTTP ayarları koleksiyonuna bir nesne başvurusu belirtir. New-AzApplicationGatewayBackendHttp Ayarlar cmdlet'ini ve buna benzer söz dizimini kullanarak bu nesne başvurularını oluşturabilirsiniz: $Http Ayarlar = New-AzApplicationGatewayBackendHttp Ayarlar -Name "ContosoHttp Ayarlar" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Sonuçta elde edilen değişken $Http Ayarlar, defaultBackendAddressPool parametresi için parametre değeri olarak kullanılabilir: -DefaultBackendHttp Ayarlar $Http Ayarlar Arka uç HTTP ayarları arka uç havuzu için bağlantı noktası, protokol ve tanımlama bilgisi tabanlı benek gibi özellikleri yapılandırabilir. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendHttp Ayarlar Id parametresini kullanamazsınız.

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

-BackendHttpSettingsId

Ağ geçidi yolu kuralı yapılandırma ayarlarına eklenebilen mevcut bir arka uç HTTP ayarları koleksiyonunun kimliğini belirtir. HTTP ayarı kimlikleri Get-AzApplicationGatewayBackendHttp Ayarlar cmdlet'i kullanılarak döndürülebilir. Kimliği aldıktan sonra DefaultBackendHttp Ayarlar Id parametresi yerine DefaultBackendHttp Ayarlar parametresini kullanabilirsiniz. Örneğin: -DefaultBackend Ayarlar Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Ayarlar Collection/ContosoHttp Ayarlar" Arka uç HTTP ayarları bağlantı noktası, protokol, ve arka uç havuzu için tanımlama bilgisi tabanlı benzimliği. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendHttp Ayarlar parametresini kullanamazsınız.

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

En üst düzey güvenlik duvarı ilkesine yönelik nesne başvurularını belirtir. Nesne başvurusu, New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet'i kullanılarak oluşturulabilir. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Yukarıdaki komut dosyası kullanılarak oluşturulan bir güvenlik duvarı ilkesine yol kuralı düzeyinde başvurulabilir. yukarıdaki komutu varsayılan ilke ayarlarını ve yönetilen kuralları oluşturur. Varsayılan değerler yerine, kullanıcılar sırasıyla New-AzApplicationGatewayFirewallPolicy Ayarlar ve New-AzApplicationGatewayFirewallPolicyManagedRules kullanarak Policy Ayarlar, ManagedRules belirtebilir.

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

-FirewallPolicyId

Mevcut bir üst düzey web uygulaması güvenlik duvarı kaynağının kimliğini belirtir. Güvenlik duvarı ilkesi kimlikleri Get-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet'i kullanılarak döndürülebilir. Kimliği aldıktan sonra FirewallPolicy parametresi yerine FirewallPolicyId parametresini kullanabilirsiniz. Örneğin: -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

Bu cmdlet'in oluşturduğu yol kuralı yapılandırmasının adını belirtir.

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

-Paths

Bir veya daha fazla uygulama ağ geçidi yol kuralı belirtir.

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

Uygulama ağ geçidi RedirectConfiguration kimliği

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

Uygulama ağ geçidi rewriteRuleSet kimliği

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

Girişler

None

Çıkışlar

PSApplicationGatewayPathRule