Aracılığıyla paylaş

New-AzApplicationGatewayPathRuleConfig

  • Başvuru
Modül:
Az.Network

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

Sözdizimi

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 $HttpSettings 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, BackendHttpSettings as $HttpSettings 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.

Tür:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-BackendHttpSettings

Ağ geçidi yolu kuralı yapılandırma ayarlarına eklenecek arka uç HTTP ayarları koleksiyonuna bir nesne başvurusu belirtir. New-AzApplicationGatewayBackendHttpSettings cmdlet'ini ve buna benzer söz dizimini kullanarak bu nesne başvuruyu oluşturabilirsiniz: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" (Devre Dışı) DefaultBackendAddressPool için parametre değeri olarak elde edilen değişken $HttpSettings kullanılabilir parameter: -DefaultBackendHttpSettings $HttpSettings Arka uç HTTP ayarları arka uç havuzu için bağlantı noktası, protokol ve tanımlama bilgisi tabanlı benzenşim gibi özellikleri yapılandırmaktadır. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendHttpSettingsId parametresini kullanamazsınız.

Tür:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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-AzApplicationGatewayBackendHttpSettings cmdlet'i kullanılarak döndürülebilir. Kimliği aldıktan sonra DefaultBackendHttpSettingsId parametresi yerine DefaultBackendHttpSettingsId parametresini kullanabilirsiniz. Örneğin: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Arka uç HTTP ayarları bağlantı noktası gibi özellikleri yapılandırıyor protokolü ve arka uç havuzu için tanımlama bilgisi tabanlı benzimliği. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendHttpSettings parametresini kullanamazsınız.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

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

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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-AzApplicationGatewayFirewallPolicySettings ve New-AzApplicationGatewayFirewallPolicyManagedRules kullanarak PolicySettings, ManagedRules belirtebilir.

Tür:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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>

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

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

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Paths

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

Tür:String[]
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Tür:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RedirectConfigurationId

Uygulama ağ geçidi RedirectConfiguration kimliği

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Tür:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RewriteRuleSetId

Uygulama ağ geçidi rewriteRuleSet kimliği

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

PSApplicationGatewayPathRule