Set-AzApplicationGatewayFrontendIPConfig
語法
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 設定的應用程式閘道物件。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(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
參數屬性
參數集
SetByResource
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrivateLinkConfigurationId
PrivateLinkConfigurationId
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SetByResourceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PublicIPAddress
指定公用 IP 位址。
參數屬性
參數集
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。
輸出