Set-AzApplicationGatewayFrontendIPConfig

  • 참조
모듈:
Az.Network

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

Syntax

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

Description

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

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

예제

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

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

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

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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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로 설정

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

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

매개 변수

-ApplicationGateway

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

Type:PSApplicationGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIPAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

Type:PSApplicationGatewayPrivateLinkConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddress

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

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddressId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

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

Type:PSSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

PSApplicationGateway

출력

PSApplicationGateway