다음을 통해 공유


Get-PlaceV3

Get-PlaceV3 cmdlet을 사용하여 Places 디렉터리 내의 회의실, 작업 영역, 건물, 바닥, 섹션 또는 책상에 구성된 메타데이터를 볼 수 있습니다.

참고

  • 최신 기능 및 개선 사항에 액세스할 수 있도록 PowerShell 버전 2.0.0 이상을 Places 업데이트하는 것이 좋습니다.

구문

Get-PlaceV3
   [-Identity]
   [-AncestorId]
   [-Type]

설명

이 cmdlet을 실행하는 데 필요한 권한이 있어야 합니다. Places 관리자 역할, Exchange 관리자 역할 또는 TenantPlacesManagement 권한이 있는 사용자 지정 역할을 사용할 수 있습니다.

예제

예 1

이 예제에서는 해당 smtp 주소 식별자를 사용하여 회의실 또는 작업 영역을 반환합니다.

Get-PlaceV3 -Identity smtp@domain.com

예 2

이 예제에서는 특정 형식의 모든 위치를 반환합니다.

Get-PlaceV3 -Type Building

예 3

다음은 장소의 이름과 형식을 기준으로 PlaceId를 반환하는 예제입니다.

Get-PlaceV3 -Type Building | Where-Object -Property DisplayName -eq 'Pine Valley' | fl PlaceId

예 4

이 예제에서는 상위 항목이 특정 위치인 모든 위치를 반환합니다.

Get-PlaceV3 -AncestorId 86897e93-bcef-4c05-af9d-45116dda791f 

매개 변수

-Identity

ID 매개 변수는 보려는 위치를 지정합니다. 장소를 고유하게 식별하는 모든 값을 사용할 수 있습니다.

예를 들어 사서함(회의실 및 작업 영역)을 기반으로 하는 장소의 경우:

  • 이름 [사용되지 않음]
  • 별칭 [사용되지 않음]
  • 고유 이름(DN) [사용되지 않음]
  • 정식 DN [사용되지 않음]
  • GUID [사용되지 않음]
  • 전자 메일 주소

예를 들어 사서함(건물, 바닥, 구역 또는 책상)을 기반으로 하지 않는 장소의 경우:

  • Name_PlaceId
  • PlaceId

이 매개 변수는 Type 매개 변수와 함께 사용할 수 없습니다.

특성 설명
유형: String
위치: 0
기본값: 없음
필수: 거짓
파이프라인 입력 수락: True
와일드카드 문자 허용: 거짓

-AncestorId

AncestorId 매개 변수는 위치의 guid를 지정합니다. 지정된 위치를 찾은 경우 디렉터리 계층 구조에서 이 위치 아래의 모든 위치를 반환합니다. 예를 들어 건물의 PlaceId가 AncestorId로 제공되는 경우 명령은 디렉터리 계층 구조의 해당 건물 아래에 있는 모든 층, 구역, 회의실, 책상 풀(작업 영역) 및 책상을 반환합니다.

특성 설명
유형: String
위치: 명명 된
기본값: 없음
필수: 거짓
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

-형

Type 매개 변수는 보려는 위치의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • Room
  • RoomList
  • 공백
  • 건물
  • 섹션
  • 책상

이 매개 변수는 Identity 매개 변수와 함께 사용할 수 없습니다.

특성 설명
유형: String
위치: 명명 된
기본값: 없음
필수: 거짓
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓