New-AzureRmApplicationGateway
애플리케이션 게이트웨이를 만듭니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
New-AzureRmApplicationGateway
-Name <String>
-ResourceGroupName <String>
-Location <String>
-Sku <PSApplicationGatewaySku>
[-SslPolicy <PSApplicationGatewaySslPolicy>]
-GatewayIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration]>
[-SslCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate]>]
[-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
[-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
[-FrontendIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration]>]
-FrontendPorts <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort]>
[-Probes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe]>]
-BackendAddressPools <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>
-BackendHttpSettingsCollection <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings]>
-HttpListeners <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener]>
[-UrlPathMaps <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap]>]
-RequestRoutingRules <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule]>
[-RedirectConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration]>]
[-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
[-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
[-EnableHttp2]
[-EnableFIPS]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzureRmApplicationGateway cmdlet은 Azure 애플리케이션 게이트웨이를 만듭니다. 애플리케이션 게이트웨이에는 다음이 필요합니다.
- 리소스 그룹.
- 가상 네트워크.
- 백 엔드 서버의 IP 주소를 포함하는 백 엔드 서버 풀입니다.
- 백 엔드 서버 풀 설정입니다. 각 풀에는 풀 내의 모든 서버에 적용되는 포트, 프로토콜 및 쿠키 기반 선호도와 같은 설정이 있습니다.
- 프런트 엔드 IP 주소- 애플리케이션 게이트웨이에서 열린 IP 주소입니다. 프런트 엔드 IP 주소는 공용 IP 주소 또는 내부 IP 주소일 수 있습니다.
- 프런트 엔드 포트- 애플리케이션 게이트웨이에서 열린 공용 포트입니다. 이러한 포트에 도달한 트래픽은 백 엔드 서버로 리디렉션됩니다.
- 수신기 및 백 엔드 서버 풀을 바인딩하는 요청 라우팅 규칙입니다. 규칙은 트래픽이 특정 수신기에 도달할 때 전달해야 하는 백 엔드 서버 풀을 정의합니다. 수신기에는 프런트 엔드 포트, 프런트 엔드 IP 주소, 프로토콜(HTTP 또는 HTTPS) 및 SSL(Secure Sockets Layer) 인증서 이름(SSL 오프로드를 구성하는 경우)이 있습니다.
예제
예제 1: 애플리케이션 게이트웨이 만들기
PS C:\> $ResourceGroup = New-AzureRmResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"}
PS C:\> $Subnet = New-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
PS C:\> $VNet = New-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
PS C:\> $VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet
PS C:\> $GatewayIPconfig = New-AzureRmApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
PS C:\> $Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
PS C:\> $PoolSetting = New-AzureRmApplicationGatewayBackendHttpSettings -Name "PoolSetting01" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $FrontEndPort = New-AzureRmApplicationGatewayFrontendPort -Name "FrontEndPort01" -Port 80
# Create a public IP address
PS C:\> $PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
PS C:\> $FrontEndIpConfig = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
PS C:\> $Listener = New-AzureRmApplicationGatewayHttpListener -Name "ListenerName01" -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
PS C:\> $Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
PS C:\> $Sku = New-AzureRmApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
PS C:\> $Gateway = New-AzureRmApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku
다음 예제에서는 먼저 리소스 그룹 및 가상 네트워크와 다음을 만들어 애플리케이션 게이트웨이를 만듭니다.
- 백 엔드 서버 풀
- 백 엔드 서버 풀 설정
- 프런트 엔드 포트
- 프런트 엔드 IP 주소
- 요청 라우팅 규칙 이러한 네 가지 명령은 가상 네트워크를 만듭니다. 첫 번째 명령은 서브넷 구성을 만듭니다. 두 번째 명령은 가상 네트워크를 만듭니다. 세 번째 명령은 서브넷 구성을 확인하고 네 번째 명령은 가상 네트워크가 성공적으로 생성되었는지 확인합니다. 다음 명령은 애플리케이션 게이트웨이를 만듭니다. 첫 번째 명령은 이전에 만든 서브넷에 대해 GatewayIp01이라는 IP 구성을 만듭니다. 두 번째 명령은 백 엔드 IP 주소 목록을 사용하여 Pool01이라는 백 엔드 서버 풀을 만들고 풀을 $Pool 변수에 저장합니다. 세 번째 명령은 백 엔드 서버 풀에 대한 설정을 만들고 설정을 $PoolSetting 변수에 저장합니다. 다음 명령은 포트 80에 프런트 엔드 포트를 만들고, 이름을 FrontEndPort01로 지정하고, 포트를 $FrontEndPort 변수에 저장합니다. 다섯 번째 명령은 New-AzureRmPublicIpAddress를 사용하여 공용 IP 주소를 만듭니다. 여섯 번째 명령은 $PublicIp 사용하여 프런트 엔드 IP 구성을 만들고, 이름을 FrontEndPortConfig01로 지정하고, $FrontEndIpConfig 변수에 저장합니다. 일곱 번째 명령은 이전에 만든 $FrontEndIpConfig $FrontEndPort 사용하여 수신기를 만듭니다. 여덟 번째 명령은 수신기에 대한 규칙을 만듭니다. 아홉 번째 명령은 SKU를 설정합니다. 열 번째 명령은 이전 명령에서 설정한 개체를 사용하여 게이트웨이를 만듭니다.
매개 변수
-AsJob
백그라운드에서 cmdlet 실행
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AuthenticationCertificates
애플리케이션 게이트웨이에 대한 인증 인증서를 지정합니다.
형식: | List<T>[PSApplicationGatewayAuthenticationCertificate] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-AutoscaleConfiguration
자동 크기 조정 구성
형식: | PSApplicationGatewayAutoscaleConfiguration |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-BackendAddressPools
애플리케이션 게이트웨이의 백 엔드 주소 풀 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayBackendAddressPool] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-BackendHttpSettingsCollection
애플리케이션 게이트웨이에 대한 백 엔드 HTTP 설정 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayBackendHttpSettings] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
형식: | IAzureContextContainer |
별칭: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableFIPS
FIPS를 사용할 수 있는지 여부입니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableHttp2
HTTP2를 사용할 수 있는지 여부입니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Force
사용자 확인을 요청하지 않고 명령을 강제 실행합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FrontendIPConfigurations
애플리케이션 게이트웨이에 대한 프런트 엔드 IP 구성 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayFrontendIPConfiguration] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-FrontendPorts
애플리케이션 게이트웨이에 대한 프런트 엔드 포트 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayFrontendPort] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-GatewayIPConfigurations
애플리케이션 게이트웨이에 대한 IP 구성 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayIPConfiguration] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-HttpListeners
애플리케이션 게이트웨이에 대한 HTTP 수신기 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayHttpListener] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Location
애플리케이션 게이트웨이를 만들 지역을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
Application Gateway의 이름을 지정합니다.
형식: | String |
별칭: | ResourceName |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Probes
애플리케이션 게이트웨이에 대한 프로브를 지정합니다.
형식: | List<T>[PSApplicationGatewayProbe] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-RedirectConfigurations
리디렉션 구성 목록
형식: | List<T>[PSApplicationGatewayRedirectConfiguration] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-RequestRoutingRules
애플리케이션 게이트웨이에 대한 요청 라우팅 규칙 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewayRequestRoutingRule] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ResourceGroupName
애플리케이션 게이트웨이를 만들 리소스 그룹의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Sku
애플리케이션 게이트웨이의 SKU(재고 유지 단위)를 지정합니다.
형식: | PSApplicationGatewaySku |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SslCertificates
애플리케이션 게이트웨이에 대한 SSL(Secure Sockets Layer) 인증서 목록을 지정합니다.
형식: | List<T>[PSApplicationGatewaySslCertificate] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SslPolicy
애플리케이션 게이트웨이에 대한 SSL 정책을 지정합니다.
형식: | PSApplicationGatewaySslPolicy |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Tag
해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}
형식: | Hashtable |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-TrustedRootCertificate
신뢰할 수 있는 루트 인증서 목록
형식: | List<T>[PSApplicationGatewayTrustedRootCertificate] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-UrlPathMaps
애플리케이션 게이트웨이에 대한 URL 경로 맵을 지정합니다.
형식: | List<T>[PSApplicationGatewayUrlPathMap] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WebApplicationFirewallConfiguration
WAF(웹 애플리케이션 방화벽) 구성을 지정합니다. Get-AzureRmApplicationGatewayWebApplicationFirewallConfiguration cmdlet을 사용하여 WAF를 가져올 수 있습니다.
형식: | PSApplicationGatewayWebApplicationFirewallConfiguration |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Zone
애플리케이션 게이트웨이의 원본 위치를 나타내는 가용성 영역 목록입니다.
형식: | List<T>[String] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
PSApplicationGatewayWebApplicationFirewallConfiguration
출력
관련 링크
- New-AzureRmApplicationGatewayBackendAddressPool
- New-AzureRmApplicationGatewayBackendHttpSettings
- New-AzureRmApplicationGatewayFrontendIPConfig
- New-AzureRmApplicationGatewayFrontendPort
- New-AzureRmApplicationGatewayHttpListener
- New-AzureRmApplicationGatewayIPConfiguration
- New-AzureRmApplicationGatewayRequestRoutingRule
- New-AzureRmApplicationGatewaySku
- New-AzureRmVirtualNetwork
- New-AzureRmVirtualNetworkSubnetConfig