Test-AzureRmPrivateIPAddressAvailability

リファレンス

モジュール:: AzureRM.Network

仮想ネットワーク内のプライベート IP アドレスの可用性をテストします。

警告

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

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

構文

Test-AzureRmPrivateIPAddressAvailability
    -VirtualNetwork <PSVirtualNetwork>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Test-AzureRmPrivateIPAddressAvailability
    -ResourceGroupName <String>
    -VirtualNetworkName <String>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

説明

Test-AzureRmPrivateIPAddressAvailability コマンドレットは、指定されたプライベート IP アドレスが仮想ネットワークで使用できるかどうかをテストします。このコマンドレットは、要求されたプライベート IP アドレスが取得された場合に使用可能なプライベート IP アドレスの一覧を返します。

例

例 1: パイプラインを使用して IP アドレスが使用可能かどうかをテストする

PS C:\>Get-AzureRmVirtualNetwork -Name $vnetName -ResourceGroupName $rgname | Test-AzureRmPrivateIPAddressAvailability -IPAddress "10.0.1.10"

このコマンドは、仮想ネットワークを取得し、パイプラインオペレーターを使用して Test-AzureRmPrivateIPAddressAvailability に渡します。これにより、指定したプライベート IP アドレスが使用可能かどうかをテストします。

パラメーター

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddress

テストする IP アドレスを指定します。

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

-ResourceGroupName

仮想ネットワークのリソースグループの名前を指定します。

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

-VirtualNetwork

PSVirtualNetwork オブジェクトを指定します。

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

-VirtualNetworkName

仮想ネットワークの名前を指定します。

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

入力

PSVirtualNetwork

パラメーター: VirtualNetwork (ByValue)

出力

PSIPAddressAvailabilityResult

Get-AzureRmVirtualNetwork