Add-AzApplicationGatewayFrontendIPConfig
フロントエンド IP 構成をアプリケーション ゲートウェイに追加します。
構文
SetByResourceId
Add-AzApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-PrivateLinkConfigurationId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResource
Add-AzApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzApplicationGatewayFrontendIPConfig コマンドレットは、フロントエンド IP 構成をアプリケーション ゲートウェイに追加します。
アプリケーション ゲートウェイは、次の 2 種類のフロントエンド IP 構成をサポートします。
パブリック IP アドレス
内部負荷分散 (ILB) を使用するプライベート IP アドレスアプリケーション ゲートウェイは、最大で 1 つのパブリック IP と 1 つのプライベート 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 = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp
最初のコマンドは、パブリック IP アドレス オブジェクトを作成し、$PublicIp変数に格納します。
2 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。
3 番目のコマンドは、$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 = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1
最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。
2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。
3 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。
4 番目のコマンドは、2 番目のコマンドの$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 = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet
最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。
2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。
3 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。
4 番目のコマンドは、2 番目のコマンドの$Subnetを使用して、FrontendIP02 という名前のフロントエンド IP 構成を追加します。
パラメーター
-ApplicationGateway
このコマンドレットがフロントエンド IP 構成を追加するアプリケーション ゲートウェイを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Name
追加するフロントエンド IP 構成の名前を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PrivateIPAddress
アプリケーション ゲートウェイのフロントエンド IP として追加するプライベート IP アドレスを指定します。
指定した場合、この IP はサブネットから静的に割り当てられます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PrivateLinkConfiguration
PrivateLinkConfiguration
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PrivateLinkConfigurationId
PrivateLinkConfigurationId
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
SetByResourceId
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PublicIPAddress
このコマンドレットがアプリケーション ゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PublicIPAddressId
このコマンドレットがアプリケーション ゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスの ID を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
SetByResourceId
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Subnet
このコマンドレットがフロントエンド IP 構成として追加するサブネットを指定します。
このパラメーターを指定すると、アプリケーション ゲートウェイがプライベート IP ベースの構成をサポートすることを意味します。
PrivateIPAddress パラメーターが指定されている場合は、このサブネットに属している必要があります。
PrivateIPAddress が指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーション ゲートウェイのフロントエンド IP アドレスとして動的に取得されます。
パラメーターのプロパティ
型: PSSubnet
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
SetByResource
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SubnetId
このコマンドレットがフロントエンド IP 構成として追加するサブネット ID を指定します。
サブネットを渡すことは、プライベート IP を意味します。
PrivateIPAddress パラメーターが指定されている場合は、このサブネットに属している必要があります。
それ以外の場合、このサブネットの IP の 1 つが、アプリケーション ゲートウェイのフロントエンド IP として動的に取得されます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
SetByResourceId
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力