你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Test-AzPrivateIPAddressAvailability

测试虚拟网络中专用 IP 地址的可用性。

语法

TestByResource

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

TestByResourceId

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

说明

Test-AzPrivateIPAddressAvailability cmdlet 测试指定的专用 IP 地址是否在虚拟网络中可用。 如果获取请求的专用 IP 地址,此 cmdlet 将返回可用专用 IP 地址的列表。

示例

示例 1:测试是否使用管道提供 IP 地址

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

此命令获取虚拟网络,并使用管道操作员将其传递给 Test-AzPrivateIPAddressAvailability,用于测试指定的专用 IP 地址是否可用。

参数

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IPAddress

指定要测试的 IP 地址。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

指定虚拟网络的资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

TestByResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-VirtualNetwork

指定 PSVirtualNetwork 对象。

参数属性

类型:PSVirtualNetwork
默认值:None
支持通配符:False
不显示:False

参数集

TestByResource
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-VirtualNetworkName

指定虚拟网络的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

TestByResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSVirtualNetwork

输出

PSIPAddressAvailabilityResult