다음을 통해 공유

New-AzApplicationGatewayPathRuleConfig

  • 참조
모듈:
Az.Network

애플리케이션 게이트웨이 경로 규칙을 만듭니다.

구문

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은 애플리케이션 게이트웨이 경로 규칙을 만듭니다. 이 cmdlet에서 만든 규칙을 URL 경로 맵 구성 설정 컬렉션에 추가한 다음 게이트웨이에 할당할 수 있습니다. 경로 맵 구성 설정은 애플리케이션 게이트웨이 부하 분산에 사용됩니다.

예제

예제 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

이러한 명령은 새 애플리케이션 게이트웨이 경로 규칙을 만든 다음 Add-AzApplicationGatewayUrlPathMapConfig cmdlet을 사용하여 해당 규칙을 애플리케이션 게이트웨이에 할당합니다. 이를 위해 첫 번째 명령은 게이트웨이 ContosoApplicationGateway에 대한 개체 참조를 만듭니다. 이 개체 참조는 $Gateway 변수에 저장됩니다. 다음 두 명령은 백 엔드 주소 풀과 백 엔드 HTTP 설정 개체를 만듭니다. 경로 규칙 개체를 만들려면 이러한 개체($AddressPool 및 $HttpSettings 변수에 저장됨)가 필요합니다. 네 번째 명령은 경로 규칙 개체를 만들고 $PathRuleConfig 변수에 저장됩니다. 다섯 번째 명령은 Add-AzApplicationGatewayUrlPathMapConfig 사용하여 구성 설정 및 해당 설정 내에 포함된 새 경로 규칙을 ContosoApplicationGateway에 추가합니다.

예제 2

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

이러한 명령은 이름이 "base"로, 경로가 "/base"로, BackendAddressPool이 $AddressPool, BackendHttpSettings를 $HttpSettings, FirewallPolicy를 $firewallPolicy.ngs로, ContosoApplicationGateway에 대한 해당 설정 내에 포함된 새 경로 규칙을 사용하여 경로 규칙을 만듭니다.

매개 변수

-BackendAddressPool

게이트웨이 경로 규칙 구성 설정에 추가할 백 엔드 주소 풀 설정 컬렉션에 대한 개체 참조를 지정합니다. 다음과 유사한 New-AzApplicationGatewayBackendAddressPool cmdlet 및 구문을 사용하여 이 개체 참조를 만들 수 있습니다. $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" 이전 명령은 주소 풀에 두 개의 IP 주소(192.16.1.1 및 192.168.1.2)를 추가합니다. IP 주소는 따옴표로 묶고 쉼표를 사용하여 구분됩니다. 그런 다음 결과 변수인 $AddressPool DefaultBackendAddressPool 매개 변수의 매개 변수 값으로 사용할 수 있습니다. 백 엔드 주소 풀은 백 엔드 서버의 IP 주소를 나타냅니다. 이러한 IP 주소는 가상 네트워크 서브넷에 속하거나 공용 IP 주소여야 합니다. 이 매개 변수를 사용하는 경우 동일한 명령에서 DefaultBackendAddressPoolId 매개 변수를 사용할 수 없습니다.

형식:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-BackendAddressPoolId

게이트웨이 경로 규칙 구성 설정에 추가할 수 있는 기존 백 엔드 주소 풀의 ID를 지정합니다. Get-AzApplicationGatewayBackendAddressPool cmdlet을 사용하여 주소 풀 ID를 반환할 수 있습니다. ID가 있으면 DefaultBackendAddressPool 매개 변수 대신 DefaultBackendAddressPoolId 매개 변수를 사용할 수 있습니다. 예: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" 백 엔드 주소 풀은 백 엔드 서버의 IP 주소를 나타냅니다. 이러한 IP 주소는 가상 네트워크 서브넷에 속하거나 공용 IP 주소여야 합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-BackendHttpSettings

게이트웨이 경로 규칙 구성 설정에 추가할 백 엔드 HTTP 설정 컬렉션에 대한 개체 참조를 지정합니다. 다음과 유사한 New-AzApplicationGatewayBackendHttpSettings cmdlet 및 구문을 사용하여 이 개체 참조를 만들 수 있습니다. $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" 결과 변수 $HttpSettings DefaultBackendAddressPool 매개 변수의 매개 변수 값으로 사용할 수 있습니다. -DefaultBackendHttpSettings $HttpSettings 백 엔드 HTTP 설정은 포트, 프로토콜 등의 속성을 구성합니다. 백 엔드 풀에 대한 쿠키 기반 선호도입니다. 이 매개 변수를 사용하는 경우 동일한 명령에서 DefaultBackendHttpSettingsId 매개 변수를 사용할 수 없습니다.

형식:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-BackendHttpSettingsId

게이트웨이 경로 규칙 구성 설정에 추가할 수 있는 기존 백 엔드 HTTP 설정 컬렉션의 ID를 지정합니다. http 설정 ID는 Get-AzApplicationGatewayBackendHttpSettings cmdlet을 사용하여 반환할 수 있습니다. ID가 있으면 DefaultBackendHttpSettings 매개 변수 대신 DefaultBackendHttpSettingsId 매개 변수를 사용할 수 있습니다. 예: -DefaultBackendSettings ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw -rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" 백 엔드 HTTP 설정은 포트, 프로토콜 등의 속성을 구성합니다. 백 엔드 풀에 대한 쿠키 기반 선호도입니다. 이 매개 변수를 사용하는 경우 동일한 명령에서 DefaultBackendHttpSettings 매개 변수를 사용할 수 없습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FirewallPolicy

최상위 방화벽 정책에 대한 개체 참조를 지정합니다. New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet을 사용하여 개체 참조를 만들 수 있습니다. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" 위의 commandlet을 사용하여 만든 방화벽 정책을 경로 규칙 수준에서 참조할 수 있습니다. 위의 명령은 기본 정책 설정 및 관리되는 규칙을 만듭니다. 사용자는 기본값 대신 각각 New-AzApplicationGatewayFirewallPolicySettings 및 New-AzApplicationGatewayFirewallPolicyManagedRules 사용하여 PolicySettings, ManagedRules를 지정할 수 있습니다.

형식:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FirewallPolicyId

기존 최상위 웹 애플리케이션 방화벽 리소스의 ID를 지정합니다. Get-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet을 사용하여 방화벽 정책 ID를 반환할 수 있습니다. ID가 있으면 firewallPolicy 매개 변수 대신 FirewallPolicyId 매개 변수를 사용할 수 있습니다. 예: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

이 cmdlet에서 만드는 경로 규칙 구성의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Paths

하나 이상의 애플리케이션 게이트웨이 경로 규칙을 지정합니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RedirectConfiguration

Application gateway RedirectConfiguration

형식:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RedirectConfigurationId

Application Gateway RedirectConfiguration의 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RewriteRuleSet

Application gateway RewriteRuleSet

형식:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RewriteRuleSetId

Application Gateway RewriteRuleSet의 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

출력

PSApplicationGatewayPathRule