Get-PlaceV3

使用 Get-PlaceV3 指令碼來查看 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

單位參數指定你想查看的位置。 你可以使用任何能唯一識別地點的數值。

例如，基於信箱 (會議室和工作空間的地點，) ：

• 名稱 [已棄用]
• 別名 [已棄用]
• DN) (傑出名稱 [已廢止]
• 正典 DN [已棄用]
• GUID [已棄用]
• 電子郵件地址

例如，對於不以信箱 (建築物、樓層、區域或書桌為基礎的地點) ：

• Name_PlaceId
• 地點識別

此參數不能與型別參數同時使用。

-祖先

AncestorId 參數指定了位置的指引。 若找到指定位置，則會回傳目錄階層中該位置以下的所有位置。 例如，如果某棟建築的 PlaceId 是 AncestorId，該指令會回傳該建築目錄階層下的所有樓層、區段、房間、桌池 (工作區) 和桌。

-Type

類型參數指定你想查看的地點類型。 有效值為：

• 會議室
• 房間列表
• Space
• 建築物
• Floor
• 區段
• 桌

此參數不能與身份參數同時使用。