Set-AzureRmApplicationGatewayFrontendIPConfig

リファレンス

モジュール:: AzureRM.Network

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Set-AzureRmApplicationGatewayFrontendIPConfig コマンドレットは、フロントエンド IP 構成を更新します。アプリケーションゲートウェイは、次の 2 種類のフロントエンド IP アドレスをサポートします。

パブリック IP アドレス
構成で内部負荷分散 (ILB) を使用するプライベート IP アドレス。アプリケーションゲートウェイは、最大で 1 つのパブリック IP アドレスと 1 つのプライベート IP アドレスを持つことができます。パブリック IP アドレスとプライベート IP アドレスは、フロントエンド IP アドレスとして個別に追加する必要があります。

例

例 1: パブリック IP をアプリケーションゲートウェイのフロントエンド IP として設定する

PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

最初のコマンドは、パブリック IP アドレスオブジェクトを作成し、$PublicIp変数に格納します。 2 番目のコマンドは、ResourceGroup01 という名前のリソースグループに属する ApplicationGateway01 という名前のアプリケーションゲートウェイを取得し、$AppGw変数に格納します。 3 番目のコマンドは、$PublicIpに格納されているアドレスを使用して、$AppGw内のゲートウェイの FrontEndIp01 という名前のフロントエンド IP 構成を更新します。

例 2: 静的プライベート IP をアプリケーションゲートウェイのフロントエンド IP として設定する

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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 を設定する

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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:	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

-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

パラメーター: ApplicationGateway (ByValue)

出力