Test-AzPrivateIPAddressAvailability

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

構文

Test-AzPrivateIPAddressAvailability
    -VirtualNetwork <PSVirtualNetwork>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzPrivateIPAddressAvailability
    -ResourceGroupName <String>
    -VirtualNetworkName <String>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

説明

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

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

Get-AzVirtualNetwork -Name $vnetName -ResourceGroupName $rgname | Test-AzPrivateIPAddressAvailability -IPAddress "10.0.1.10"

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

パラメーター

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, 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

出力

PSIPAddressAvailabilityResult