New-AzApplicationGatewayPathRuleConfig

Modül:
Az.Network Module

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

Syntax

SetByResourceId 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

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. Aşağıdakine benzer New-AzApplicationGatewayBackendAddressPool cmdlet'ini ve 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.

Parametre özellikleri

Tür:PSApplicationGatewayBackendAddressPool
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-BackendHttpSettings

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

Parametre özellikleri

Tür:PSApplicationGatewayBackendHttpSettings
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 Kimliği "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft. Ağ/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Arka uç HTTP ayarları, arka uç havuzu için bağlantı noktası, protokol ve tanımlama bilgisi tabanlı benzeşim gibi özellikleri yapılandırmaktadır. Bu parametreyi kullanırsanız, aynı komutta DefaultBackendHttpSettings parametresini kullanamazsınız.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-FirewallPolicy

En üst düzey güvenlik duvarı ilkesine yönelik nesne başvurularını belirtir. Nesne başvurusu, New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet kullanılarak oluşturulabilir. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Yukarıdaki cmdlet 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.

Parametre özellikleri

Tür:PSApplicationGatewayWebApplicationFirewallPolicy
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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>

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Paths

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Parametre özellikleri

Tür:PSApplicationGatewayRedirectConfiguration
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-RedirectConfigurationId

Uygulama ağ geçidi RedirectConfiguration kimliği

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Parametre özellikleri

Tür:PSApplicationGatewayRewriteRuleSet
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-RewriteRuleSetId

Uygulama ağ geçidi rewriteRuleSet kimliği

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Çıkışlar

PSApplicationGatewayPathRule