다음을 통해 공유


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

Description

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

예제

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

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

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

매개 변수

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IPAddress

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

TestByResourceId
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-VirtualNetwork

PSVirtualNetwork 개체를 지정합니다.

매개 변수 속성

형식:PSVirtualNetwork
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

TestByResource
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-VirtualNetworkName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow: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