共用方式為


Set-AzApplicationGatewayFrontendIPConfig

修改前端 IP 位址設定。

語法

SetByResourceId

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

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 變數中。 第四個命令會使用第二個命令的$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

第一個命令會取得屬於名為 ResourceGroup01 之資源群組的名為 VNet01 的虛擬網路,並將它儲存在 $VNet 變數中。 第二個命令使用第一個命令的$VNet獲取名為Subnet01的子網配置,並將其存儲在$Subnet變量中。 第三個命令會取得屬於名為 ResourceGroup01 之資源群組的名為 ApplicationGateway01 的應用程式閘道,並將它儲存在 $AppGw 變數中。 第四個命令會使用第二個命令的$Subnet新增名為 FrontendIP02 的前端 IP 設定。

參數

-ApplicationGateway

指定要修改前端 IP 設定的應用程式閘道物件。

參數屬性

類型:PSApplicationGateway
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此 Cmdlet 修改的前端 IP 設定名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PrivateIPAddress

指定專用 IP 位址。 如果指定,則此 IP 會從子網路靜態配置。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

參數屬性

類型:PSApplicationGatewayPrivateLinkConfiguration
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PublicIPAddress

指定公用 IP 位址。

參數屬性

類型:PSPublicIpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PublicIPAddressId

指定公用 IP 位址的 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Subnet

指定應用程式閘道所使用的子網路。 如果閘道使用私有 IP 位址,請指定此參數。 如果指定 PrivateIPAddress 位址,它應該屬於此子網路。 如果未指定 PrivateIPAddress ,則會動態挑選此子網路中的其中一個 IP 位址,作為應用程式閘道的前端 IP 位址。

參數屬性

類型:PSSubnet
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SubnetId

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

PSApplicationGateway

輸出

PSApplicationGateway