Get-PlaceV3
使用 Get-PlaceV3 Cmdlet 來檢視在 Places 目錄內會議室、工作區、建築物、樓層、區段或桌面上設定的元數據。
語法
Get-PlaceV3
[-Identity]
[-AncestorId]
[-Type]
描述
您必須已獲指派權限，才能執行此指令程式。 您必須具有 Exchange 管理員 角色或 Places 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
identity 參數會指定您想要檢視的位置。 您可以使用可唯一識別位置的任何值。
例如，針對以信箱 (會議室和工作區為基礎的地點) ：
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
例如，對於不是以信箱為基礎的地方， (建築物、樓層、區段或桌面) ：
- Name_PlaceId
- PlaceId
您無法搭配 Type 參數使用此參數。
| 屬性 | 描述 |
|---|---|
| 類型： | 字串 |
| 位置： | 0 |
| 預設值： | 無 |
| 必填： | 錯 |
| 接受管線輸入： | True |
| 接受通配符： | 錯 |
-AncestorId
AncestorId 參數會指定 place 的 guid。 如果找到指定的位置，它會傳回目錄階層中此位置下的所有位置。 例如，如果以 AncestorId 提供建築物的 PlaceId，此命令會傳回目錄階層中該建築物下的所有樓層、區段、會議室、桌面集區 (工作區) 和桌面。
| 屬性 | 描述 |
|---|---|
| 類型： | 字串 |
| 位置： | 叫 |
| 預設值： | 無 |
| 必填： | 錯 |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
-Type
Type 參數會指定您想要檢視的位置類型。 有效值為：
- 會議室
- RoomList
- Space
- 建築物
- Floor
- 區段
- 書桌
資料庫名稱
| 屬性 | 描述 |
|---|---|
| 類型： | 字串 |
| 位置： | 叫 |
| 預設值： | 無 |
| 必填： | 錯 |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |