New-AzureRmApplicationGatewayFrontendIPConfig
建立應用程式閘道的前端IP組態。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureRmApplicationGatewayFrontendIPConfig
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmApplicationGatewayFrontendIPConfig
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
New-AzureRmApplicationGatewayFrontendIPConfig Cmdlet 會為 Azure 應用程式閘道建立前端 IP 組態。 應用程式閘道支援兩種類型的前端IP組態：
- 公用IP位址 -- 使用內部負載平衡的私人IP位址（ILB）。 應用程式閘道最多可以有一個公用IP位址和一個私人IP位址。 公用IP位址和私人IP位址應該分別新增為前端IP位址。
範例
範例 1：使用公用 IP 資源物件建立前端 IP 組態
PS C:\>$PublicIP = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP第一個命令會建立公用IP資源物件，並將其儲存在$PublicIP變數中。 第二個命令會使用 $PublicIP 建立名為 FrontEndIP01 的新前端 IP 組態，並將它儲存在 $FrontEnd 變數中。
範例 2：建立靜態私人 IP 作為前端 IP 位址
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1第一個命令會取得名為 VNet01 的虛擬網路，該虛擬網路屬於名為 ResourceGroup01 的資源群組，並將它儲存在$VNet變數中。 第二個命令會使用第一個命令的 $VNet，取得名為 Subnet01 的子網組態，並將它儲存在$Subnet變數中。 第三個命令 $Subnet會使用第二個命令和私人IP位址10.0.1.1建立名為 FrontEndIP02 的前端IP組態，然後將它儲存在$FrontEnd變數中。
範例 3：建立動態私人 IP 作為前端 IP 位址
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -Subnet $Subnet第一個命令會取得名為 VNet01 的虛擬網路，該虛擬網路屬於名為 ResourceGroup01 的資源群組，並將它儲存在$VNet變數中。 第二個命令會使用第一個命令的 $VNet，取得名為 Subnet01 的子網組態，並將它儲存在$Subnet變數中。 第三個命令會使用第二個命令的 $Subnet，建立名為 FrontEndIP03 的前端 IP 組態，並將它儲存在 $FrontEnd 變數中。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定此 Cmdlet 所建立的前端 IP 組態名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PrivateIPAddress
指定此 Cmdlet 與應用程式閘道前端 IP 位址相關聯的私人 IP 位址。 只有在指定子網時，才能指定這個值。 此 IP 會從子網以靜態方式配置。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PublicIPAddress
指定此 Cmdlet 與應用程式閘道前端 IP 位址相關聯的公用 IP 位址物件。
| 類型: | PSPublicIpAddress |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PublicIPAddressId
指定此 Cmdlet 與應用程式閘道前端 IP 相關聯的公用 IP 位址識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Subnet
指定此 Cmdlet 與應用程式閘道前端 IP 位址相關聯的子網物件。 如果您指定此參數，表示閘道使用私人IP位址。 如果指定 PrivateIPAddresss 參數，它應該屬於此參數所指定的子網。 如果未 指定 PrivateIPAddress ，此子網中的其中一個 IP 位址會動態挑選為應用程式閘道的前端 IP 位址。
| 類型: | PSSubnet |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SubnetId
指定此 Cmdlet 與應用程式閘道前端 IP 組態相關聯的子網標識碼。 如果您指定 Subnet 參數，則表示閘道會使用私人 IP 位址。 如果指定 PrivateIPAddress 參數，它應該屬於 Subnet 所指定的子網。 如果未 指定 PrivateIPAddress ，此子網中的其中一個 IP 位址會動態挑選為應用程式閘道的前端 IP 位址。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
PSApplicationGatewayFrontendIPConfiguration