다음을 통해 공유


Get-MsolContact

Azure Active Directory에서 연락처를 가져옵니다.

Syntax

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolContact cmdlet은 연락처 개체 또는 연락처 목록을 가져옵니다. ObjectId 매개 변수를 지정하여 단일 연락처를 가져옵니다.

예제

예제 1: 연락처 가져오기

PS C:\> Get-MsolContact -ObjectId adc41dc7-4130-4215-adfb-2403bc9f844e

이 명령은 연락처를 검색합니다.

예제 2: 문자열과 일치하는 연락처 가져오기

PS C:\> Get-MsolContact -SearchString "Patti"

이 명령은 Patti로 시작하는 표시 이름 또는 전자 메일 주소가 있는 연락처 목록을 검색합니다.

매개 변수

-All

이 cmdlet이 찾은 모든 결과를 반환한다는 것을 나타냅니다. 이 매개 변수와 MaxResults 매개 변수를 지정하지 마세요.

형식:SwitchParameter
Position:Named
기본값:None
필수:True
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

이 cmdlet은 유효성 검사 오류가 있는 연락처를 반환한다는 것을 나타냅니다.

형식:Boolean
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

이 cmdlet이 반환하는 최대 결과 수를 지정합니다. 기본값은 500입니다.

형식:Int32
Position:Named
기본값:500
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

가져올 연락처의 고유 개체 ID를 지정합니다.

형식:Guid
Position:Named
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

문자열을 지정합니다. 이 cmdlet은 이 문자열로 시작하는 표시 이름 또는 전자 메일 주소가 있는 연락처를 반환합니다.

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

형식:Guid
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

출력

Microsoft.Online.Administration.Contact

이 cmdlet은 다음 정보를 포함하는 연락처 개체를 반환합니다.

  • 도시. 연락처의 구/군/시입니다.

  • 국가입니다. 연락처의 국가 또는 지역입니다.

  • 부서. 연락처의 부서입니다.

  • DisplayName. 연락처의 표시 이름입니다.

  • 팩스. 연락처의 팩스 번호입니다.

  • 이름. 연락처의 이름입니다.

  • LastDirSyncTime. 마지막 동기화 날짜와 시간을 반환합니다. Active Directory 동기화를 통해 동기화된 연락처에서만 반환됩니다.

  • LastName 연락처의 성입니다.

  • MobilePhone. 연락처의 휴대폰 번호입니다.

  • Objectid. 연락처의 고유 ID입니다.

  • 사무실. 연락처의 사무실 번호입니다.

  • 전화 번호입니다. 연락처의 전화 번호입니다.

  • 우편 번호. 연락처의 우편 번호입니다.

  • 프록시 주소. 이 연락처와 연결된 프록시 주소입니다.

  • 상태 연락처의 구/군/시입니다.

  • StreetAddress. 연락처의 주소입니다.

  • 제목입니다. 연락처의 제목입니다.

  • UserPrincipalName. 연락처의 사용자 ID입니다.

  • ValidationStatus입니다. 연락처에 오류가 발생했는지 여부입니다.