New-AzureRmVmssIpConfig

VMSS のネットワーク インターフェイスの IP 構成を作成します。

警告

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

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

構文

New-AzureRmVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzureRmVmssIpConfig コマンドレットは、仮想マシン スケール セット (VMSS) のネットワーク インターフェイスの IP 構成オブジェクトを作成します。 Add-AzureRmVmssNetworkInterfaceConfiguration コマンドレットの IPConfiguration パラメーターとして、このコマンドレットの構成を指定します。

例 1: VMSS インターフェイスの IP 構成オブジェクトを作成する

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

このコマンドは、ContosoVmssInterface02 という名前の IP 構成オブジェクトを作成します。 このコマンドは、$SubnetIdに格納されている、以前に定義されたサブネット ID を使用します。 このコマンドは、後で Add-AzureRmVmssNetworkInterfaceConfiguration使用するために、構成設定を $IPConfiguration 変数に格納します。

例 2: NAT プール設定を含む IP 構成オブジェクトを作成する

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

このコマンドは、ContosoVmssInterface03 という名前の IP 構成オブジェクトを作成し、後で使用できるように$IPConfiguration変数に格納します。 このコマンドは、$SubnetIdに格納されている、以前に定義されたサブネット ID を使用します。 このコマンドは、後で使用できるように構成設定を $IPConfiguration 変数に格納します。 このコマンドは、LoadBalancerInboundNatPoolsId パラメーターと LoadBalancerBackendAddressPoolsId パラメーターの値指定します。

パラメーター

-ApplicationGatewayBackendAddressPoolsId

ロード バランサーのバックエンド アドレス プールへの参照の配列を指定します。 スケール セットは、1 つのパブリック ロード バランサーと 1 つの内部ロード バランサーのバックエンド アドレス プールを参照できます。 複数のスケール セットで同じロード バランサーを使用することはできません。

Type:String[]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-DnsSetting

パブリック IP アドレスに適用する DNS 設定。 パブリック IP アドレスに適用する Dns 設定の doメイン 名ラベル。 doメイン 名前ラベルと vm インデックスの連結は、作成されるパブリック IP アドレス リソースの doメイン 名前ラベルになります。

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

-Id

ID を指定します。

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

-IpTag

Ip タグ オブジェクトの配列を指定します。

Type:VirtualMachineScaleSetIpTag[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPoolsId

ロード バランサーの受信ネットワーク アドレス変換 (NAT) プールへの参照の配列を指定します。 スケール セットは、1 つのパブリック ロード バランサーと 1 つの内部ロード バランサーの受信 NAT プールを参照できます。 複数のスケール セットで同じロード バランサーを使用することはできません。

Type:String[]
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatPoolsId

ロード バランサーの受信 NAT プールへの参照の配列を指定します。 スケール セットは、1 つのパブリック ロード バランサーと 1 つの内部ロード バランサーの受信 NAT プールを参照できます。 複数のスケール セットで同じロード バランサーを使用することはできません。

Type:String[]
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

IP 構成の名前を指定します。

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

-Primary

ネットワーク インターフェイスに複数の IP 構成がある場合のプライマリ IP 構成を指定します。

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

-PrivateIPAddressVersion

IP 構成が IPv4 または IPv6 であることを指定します。 既定値は IPv4 と見なされます。 使用可能な値は、'IPv4' と 'IPv6' です。

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

パブリック IP アドレスのアイドル タイムアウト。

Type:Int32
Aliases:PublicIPAddressIdleTimeoutInMinutes
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIPAddressConfigurationName

publicIP アドレス構成名。

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

-PublicIPPrefix

パブリック IP プレフィックスの ID

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

-SubnetId

構成が VMSS ネットワーク インターフェイスを作成するサブネット ID を指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

出力

VirtualMachineScaleSetIPConfiguration