Set-AzApplicationGatewayFrontendIPConfig

  • リファレンス
モジュール:
Az.Network

フロントエンド IP アドレス構成を変更します。

構文

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>]

説明

Set-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 = Set-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 = Set-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 = Set-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 構成を変更するアプリケーション ゲートウェイ オブジェクトを指定します。

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

このコマンドレットが変更するフロントエンド 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 アドレスの ID を指定します。

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

-Subnet

アプリケーション ゲートウェイが使用するサブネットを指定します。 ゲートウェイがプライベート IP アドレスを使用する場合は、このパラメーターを指定します。 PrivateIPAddress アドレスが指定されている場合は、このサブネットに属している必要があります。 PrivateIPAddress が指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーション ゲートウェイのフロントエンド IP アドレスとして動的に取得されます。

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

-SubnetId

サブネット ID を指定します。 ゲートウェイがプライベート IP アドレスを使用する場合は、このパラメーターを指定します。 PrivateIPAddress パラメーターが指定されている場合は、このサブネットに属している必要があります。 PrivateIPAddress が指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーション ゲートウェイのフロントエンド IP アドレスとして動的に取得されます。

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

入力

PSApplicationGateway

出力

PSApplicationGateway