다음을 통해 공유

New-AzureRmApplicationGatewayPathRuleConfig

  • 참조
모듈:
AzureRM.Network

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

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RedirectConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

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

예제

예 1

PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

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

매개 변수

-BackendAddressPool

게이트웨이 경로 규칙 구성 설정에 추가할 백 엔드 주소 풀 설정 컬렉션에 대한 개체 참조를 지정합니다. New-AzureRmApplicationGatewayBackendAddressPool cmdlet 및 다음과 유사한 구문을 사용하여 이 개체 참조를 만들 수 있습니다. $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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-AzureRmApplicationGatewayBackendAddressPool 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-AzureRmApplicationGatewayBackendHttp설정 cmdlet 및 구문을 사용하여 이 개체 참조를 만들 수 있습니다. $Http설정 = New-AzureRmApplicationGatewayBackendHttp설정 -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" 결과 변수 $Http설정 DefaultBackendAddressPool의 매개 변수 값으로 사용할 수 있습니다. 매개 변수: -DefaultBackendHttp설정 $Http설정 백 엔드 HTTP 설정은 백 엔드 풀에 대한 포트, 프로토콜 및 쿠키 기반 선호도와 같은 속성을 구성합니다. 이 매개 변수를 사용하는 경우 동일한 명령에서 DefaultBackendHttp설정Id 매개 변수를 사용할 수 없습니다.

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

-BackendHttpSettingsId

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

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

-DefaultProfile

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

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

-Name

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

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

-Paths

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

형식:List<T>[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

입력

None

출력

PSApplicationGatewayPathRule