New-Place

使用 New-Place Cmdlet 在 Places 目錄內建立建築物、樓層、區段或桌面。

語法

建築物

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

Floor

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-SortOrder]
 [-Tags]

區段

區段是樓層內的空格群組，例如鄰近地區。 桌面和工作區必須是區段的父系。 會議室也可以選擇性地成為區段的父代，也可以直接將它們父系到樓層。

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

書桌

桌面是 Places 中的新實體類型，代表個別的桌面。 這些物件可以是可預訂或不可預約的 (預設) 。

若要讓桌面可預訂，您必須建立 Desk 信箱，並將信箱 Alias 傳遞至 Mailbox 的 Set-PlaceV3參數，以將它與桌面對象產生關聯。 請注意，不同於會議室/工作區類型，桌面不會透過單獨建立信箱來隱含布建。 此外，元數據 (例如 Capacity 或 DisplayName 字段) 不會與信箱元數據保持同步。 信箱主要是保留引擎的必要專案，而且會從 Places Directory 讀取元數據。

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]

描述

Places 取決於您會議室/工作區、樓層和建築物之間的完整設定階層。 一旦建立建築物和樓層，您就可以使用 parentId 連結它們。 房間應該有父樓層或區段。 工作區或桌面應具有父區段。 區段應該具有父樓層。 樓層應該有父建築物。

您必須已獲指派權限，才能執行此指令程式。 您必須擁有 Exchange 管理員 角色或 Places TenantPlacesManagement 角色。

範例

範例 1

此範例會在該建築物內建立新的建築物和樓層。

New-Place -Type Building -Name 'Building 3'

成功建立建築物 3 之後，請閱讀其 PlaceId，以在樓層上設定 ParentId 時使用。

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

範例 2

此範例會建立具有地址資訊的新建築物。

New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

範例 3

此範例會建立具有資源連結的新建築物。

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

範例 4

此範例會建立以樓層為父系的區段，然後建立桌面信箱，並將它指派給現有的桌面實體。 請注意，您已 ExchangeOnlineManagement 安裝模組並 Connect-ExchangeOnline 執行 Cmdlet，然後再執行此範例腳本。

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias

參數

-城市

City 參數會指定建築物的城市。 如果值包含空格，請使用引號 (") 括住值。 最大長度為 200 個字元。

-CountryOrRegion

CountryOrRegion 參數會指定建築物的國家或地區。 有效的值是有效的 ISO 3166-1 兩個字母的國家/地區代碼 (例如，澳大利亞) 的 AU，或與官方 ISO 3166 維護機構簡短名稱) 不同的國家/地區 (對應的易記名稱。

兩個字母的國家/地區代碼參考可在國家/ 地區代碼清單取得。

[Places 探索] 頁面會使用地址信息來顯示附近的建築物。

-Label

Label 參數會指定位置的描述性標籤。 如果值包含空格，請使用引號 (") 括住值。 最大長度為 200 個字元。

-GeoCoordinates

GeoCoordinates 參數會指定建築物在緯度、經度和 (選擇性地) 高度座標的位置。 此參數的有效值會使用下列其中一種格式：

• 緯度和經度：例如，“47.644125;-122.122411”
• 緯度、經度和高度：例如，「47.644125;-122.122411;161.432"

-DisplayName

DisplayName 參數會指定位置的顯示名稱。 最大長度為 200 個字元。

建築物的顯示名稱是可見的：

• 在 Outlook 中，當使用者設定其工作時間和位置時，他們可以選取建築物。
• 在 [Places 探索] 頁面中，顯示其他誰在相同的建築物、附近的建築物等等中。
• 在 Places Finder 中，當您搜尋會議室或工作區時做為篩選條件。

在搜尋會議室或工作區時，Places Finder 中會顯示樓層的顯示名稱作為篩選條件。

-ParentId

ParentId 參數會指定 Microsoft Places 中父位置階層中 Place 的標識碼。

• 房間應該有父樓層或區段。
• 工作區或桌面應具有父區段。
• 區段應該具有父樓層。
• 樓層應該有父建築物。

-PostalCode

PostalCode 參數會指定建築物的郵遞區編碼。 最大長度為 200 個字元。

-ResourceLinks

ResourceLinks 參數會指定應該與此建築物相關聯的外部連結或 Teams 應用程式 識別碼，例如功能表、服務鏈接或用於訪客管理的 Teams 應用程式。 如需如何在 Places 中設定服務的詳細資訊，請參閱 Places 中的服務。

此值必須提供為連結的陣列，如 範例 4 所示。 每個鏈接都應該包含下列屬性：Name、Value 和 Type。  例如，鏈接會寫成 @{name=“TestLink”; value=“https://contoso.com/"; type=”Url“}。

• 名稱
  • 此字串可用來顯示您的連結或應用程式名稱在 Places 應用程式中的顯示方式。
  • 最大長度為 200 個字元。
• 值
  • 此值應該是 URL 連結或 Teams 應用程式識別碼。 您可以在 Teams 系統管理中心的 [ 管理應用程式 ] 頁面中，於應用程式的 [應用程式詳細數據] 頁面中找到 Teams 應用程式識別碼。
  • 最大長度為 1000 個字元。
• 類型 必須是其中一個支援的類型：
  • URL - 指出這是 URL 連結。
  • MetaOsApp - 指出此連結是 Teams 應用程式。

-SortOrder

SortOrder 參數會指定樓層的排序順序。 例如，樓層可能命名為 「Lobby」，排序順序為 0，以在排序列表中先顯示此樓層。

-州

State 參數會指定建築物的州或省。 最大長度為 200 個字元。

-街

Street 參數會指定建築物的實體位址。 最大長度為 200 個字元。

-標籤

Tags 參數會指定房間 (的其他功能，例如檢視類型或) 的房間類型等詳細數據。 目前沒有長度上限。

您可以指定多個以逗號分隔的標籤。 如果標籤包含空格，請以引弧括住值： "Label 1","Label 2",..."Label N"。

-Type

Type 參數會指定要建立之位置的類型。 有效值為：

• 建築物
• Floor
• 區段
• 書桌