다음을 통해 공유


Test-AzureRmPrivateIPAddressAvailability

가상 네트워크에서 개인 IP 주소의 가용성을 테스트합니다.

Warning

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>]

Description

Test-AzureRmPrivateIPAddressAvailability cmdlet은 가상 네트워크에서 지정된 개인 IP 주소를 사용할 수 있는지 여부를 테스트합니다. 이 cmdlet은 요청된 개인 IP 주소를 사용하는 경우 사용 가능한 개인 IP 주소 목록을 반환합니다.

예제

예제 1: 파이프라인을 사용하여 IP 주소를 사용할 수 있는지 테스트

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

이 명령은 가상 네트워크를 가져오고 파이프라인 연산자를 사용하여 지정된 개인 IP 주소를 사용할 수 있는지 여부를 테스트하는 Test-AzureRmPrivateIPAddressAvailability에 전달합니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IPAddress

테스트할 IP 주소를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

가상 네트워크에 대한 리소스 그룹의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VirtualNetwork

PSVirtualNetwork 개체를 지정합니다.

형식:PSVirtualNetwork
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VirtualNetworkName

가상 네트워크의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PSVirtualNetwork

매개 변수: VirtualNetwork(ByValue)

출력

PSIPAddressAvailabilityResult