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變數中。 第二個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在$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

第一個命令會取得名為 VNet01 的虛擬網路，該虛擬網路屬於名為 ResourceGroup01 的資源群組，並將它儲存在$VNet變數中。 第二個命令會使用第一個命令的 $VNet，取得名為 Subnet01 的子網組態，並將它儲存在$Subnet變數中。 第三個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在$AppGw變數中。 第四個命令會使用第二個命令的 $Subnet 和私人IP位址 10.0.1.1，新增名為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

第一個命令會取得名為 VNet01 的虛擬網路，該虛擬網路屬於名為 ResourceGroup01 的資源群組，並將它儲存在$VNet變數中。 第二個命令會使用第一個命令的 $VNet，取得名為 Subnet01 的子網組態，並將它儲存在$Subnet變數中。 第三個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在$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位址的識別碼。

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

指定子網標識碼。 如果閘道使用私人IP位址，請指定此參數。 如果指定 PrivateIPAddress 參數，它應該屬於這個子網。 如果未 指定 PrivateIPAddress ，此子網中的其中一個 IP 位址會動態挑選為應用程式閘道的前端 IP 位址。

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

輸入

PSApplicationGateway

輸出

PSApplicationGateway