다음을 통해 공유


Set-AzureRmApplicationGatewayFrontendIPConfig

프런트 엔드 IP 주소 구성을 수정합니다.

Warning

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

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

구문

Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmApplicationGatewayFrontendIPConfig cmdlet은 프런트 엔드 IP 구성을 업데이트합니다. 애플리케이션 게이트웨이는 다음 두 가지 유형의 프런트 엔드 IP 주소를 지원합니다.

  • 공용 IP 주소
  • 구성에서 ILB(내부 부하 분산)를 사용하는 개인 IP 주소는 애플리케이션 게이트웨이에 최대 하나의 공용 IP 주소와 하나의 개인 IP 주소를 가질 수 있습니다. 공용 IP 주소와 개인 IP 주소는 프런트 엔드 IP 주소로 별도로 추가해야 합니다.

예제

예제 1: 공용 IP를 애플리케이션 게이트웨이의 프런트 엔드 IP로 설정

PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

첫 번째 명령은 공용 IP 주소 개체를 만들고 $PublicIp 변수에 저장합니다. 두 번째 명령은 ResourceGroup01이라는 리소스 그룹에 속하는 ApplicationGateway01이라는 애플리케이션 게이트웨이를 가져오고 $AppGw 변수에 저장합니다. 세 번째 명령은 $PublicIp 저장된 주소를 사용하여 $AppGw 게이트웨이에 대해 FrontEndIp01이라는 프런트 엔드 IP 구성을 업데이트합니다.

예제 2: 정적 개인 IP를 애플리케이션 게이트웨이의 프런트 엔드 IP로 설정

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

첫 번째 명령은 ResourceGroup01이라는 리소스 그룹에 속하는 VNet01이라는 가상 네트워크를 가져오고 $VNet 변수에 저장합니다. 두 번째 명령은 첫 번째 명령의 $VNet 사용하여 Subnet01이라는 서브넷 구성을 가져오고 $Subnet 변수에 저장합니다. 세 번째 명령은 ResourceGroup01이라는 리소스 그룹에 속하는 ApplicationGateway01이라는 애플리케이션 게이트웨이를 가져오고 $AppGw 변수에 저장합니다. 네 번째 명령은 두 번째 명령과 개인 IP 주소 10.0.1.1의 $Subnet 사용하여 FrontendIP02라는 프런트 엔드 IP 구성을 추가합니다.

예제 3: 동적 개인 IP를 애플리케이션 게이트웨이의 프런트 엔드 IP로 설정

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

첫 번째 명령은 ResourceGroup01이라는 리소스 그룹에 속하는 VNet01이라는 가상 네트워크를 가져오고 $VNet 변수에 저장합니다. 두 번째 명령은 첫 번째 명령의 $VNet 사용하여 Subnet01이라는 서브넷 구성을 가져오고 $Subnet 변수에 저장합니다. 세 번째 명령은 ResourceGroup01이라는 리소스 그룹에 속하는 ApplicationGateway01이라는 애플리케이션 게이트웨이를 가져오고 $AppGw 변수에 저장합니다. 네 번째 명령은 두 번째 명령의 $Subnet 사용하여 FrontendIP02라는 프런트 엔드 IP 구성을 추가합니다.

매개 변수

-ApplicationGateway

프런트 엔드 IP 구성을 수정할 애플리케이션 게이트웨이 개체를 지정합니다.

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

-DefaultProfile

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

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

-Name

이 cmdlet에서 수정하는 프런트 엔드 IP 구성의 이름을 지정합니다.

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

-PrivateIPAddress

개인 IP 주소를 지정합니다. 지정된 경우 이 IP는 서브넷에서 정적으로 할당됩니다.

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

-PublicIPAddress

공용 IP 주소를 지정합니다.

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

-PublicIPAddressId

공용 IP 주소의 ID를 지정합니다.

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

-Subnet

애플리케이션 게이트웨이에서 사용하는 서브넷을 지정합니다. 게이트웨이에서 개인 IP 주소를 사용하는 경우 이 매개 변수를 지정합니다. PrivateIPAddress 주소가 지정된 경우 이 서브넷에 속해야 합니다. PrivateIPAddress를 지정하지 않으면 이 서브넷의 IP 주소 중 하나가 애플리케이션 게이트웨이의 프런트 엔드 IP 주소로 동적으로 선택됩니다.

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

-SubnetId

서브넷 ID를 지정합니다. 게이트웨이에서 개인 IP 주소를 사용하는 경우 이 매개 변수를 지정합니다. PrivateIPAddress 매개 변수가 지정된 경우 이 서브넷에 속해야 합니다. PrivateIPAddress를 지정하지 않으면 이 서브넷의 IP 주소 중 하나가 애플리케이션 게이트웨이의 프런트 엔드 IP 주소로 동적으로 선택됩니다.

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

입력

PSApplicationGateway

매개 변수: ApplicationGateway(ByValue)

출력

PSApplicationGateway