New-Place

使用 New-Place 指令碼在你的 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]

會議室

建立房間會自動配置一個相關的信箱。 如果您在信箱參數中提供 EmailAddress，將會建立一個新信箱並連結到該房間。

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

工作區

建立工作區 (桌池) 會自動配置相關的信箱。 如果您在信箱參數中提供 EmailAddress，將會建立一個新信箱，並連結到工作區。

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

桌

書桌代表一個獨立的書桌單元。 每個書桌都有一個 Mode 屬性，定義了它的使用方式：

• 可預約 – 可提前預約。
• Drop-In -僅限現場使用。
• 指派 – 指派給特定使用者。
• 不可預約 – 無法預約。

桌機模式與信箱的運作方式如下：

• 預設行為： 若模式未定義，該桌面預設為「不可用」。 不會建立任何信箱。
• 可預訂或直接接入模式： 必須設置辦公桌信箱。 一個是在櫃台配置完成時自動建立的，或者你可以連結到現有的。
  • 如果您在信箱參數中提供現有的電子郵件地址，櫃台會連結到該信箱。
  • 如果你提供的電子郵件地址不存在，系統會建立一個新信箱，並連結到該櫃台。
  • 若未提供電子郵件地址，系統會自動建立一個系統生成名稱的信箱，並連結至該辦公桌。
• 指定或不可用模式： 連結信箱是可選的，且不會建立任何信箱。 不過，如果需要，你可以手動將這些書桌與自訂信箱關聯起來。
• 稍後切換模式： 如果櫃台以不可用模式開始且沒有連結信箱，使用 Set-PlacesV3 指令檔將桌面切換為可預訂，會自動建立並連結信箱。 然而，將信箱連結到書桌並不會自動更新該書桌的模式。

與房間或工作區不同，書桌不會與信箱屬性同步中繼資料，例如容量或顯示名稱。 郵箱主要由預約引擎使用，而元資料則從 Places 目錄讀取。

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

描述

Microsoft Places 要求建築、樓層、區段、房間、工作區和辦公桌有完整的階層結構。

• 一 層樓 必須屬於一棟建築。
• 一個 區域 必須屬於一個樓層。
• 房間必須屬於某層或某個區域。
• 工作區或書桌必須屬於某個區塊。

使用 ParentId 屬性來連結實體。

要執行這個 cmdlet，你需要以下其中一個角色：Places Administrator、Exchange Administrator，或是帶有 TenantPlacesManagement 權限的自訂角色。

範例

範例 1

此範例創造了一棟新建築及其內的一層樓。

New-Place -Type Building -Name 'Building 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

此範例建立一個新房間，父級為某區段，容量為 10，但未指定信箱細節。 房間信箱會自動建立並連結。

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Capacity 10

範例 5

此範例建立一個新房間，為某個區段子級，並提供信箱詳細資訊

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

範例 6

此範例建立一個新的工作區 (桌池，) 子層至一個區塊，並提供信箱詳細資訊

New-Place -Name 'Deskpool A' -Type Workspace -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

範例 7

此範例建立一個可預訂的桌面，為區塊父級，但未指定信箱細節。 桌上信箱會自動建立並連結，MailboxOID 屬性也會被填入。 該櫃台出現在 Places Finder 中，任何人都可以預約。

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'}

範例 8

此範例建立一個可預留的書桌，並以區段為父，並提供一個信箱。 如果信箱存在，該信箱會連結到該信箱，否則會自動建立一個新的信箱，並以該名稱命名。

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'} -Mailbox <mailboxAddress>

範例 9

此範例建立一個指定模式的桌面，作為一個部門的父級，並指派給某個人。 只有指定人員可以使用這個櫃台。 其他人則無法再保留。

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
New-Place -Name 'Bookable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Assigned';Metadata=$modemetadata}

參數

-城

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

-國家或地區

CountryOrRegion 參數指定建築的國家或區域。 有效的數值是有效的 ISO 3166-1 兩字母國家代碼 (，例如澳洲) 的 AU，或與官方 ISO 3166 維護機構簡稱) 不同的國家名稱 (。

關於兩字母國家代碼的參考資料可參考 Country Codes List。

地址資訊被 Places Explore 頁面用來顯示附近建築物。

-Label

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

-地理座標

地理座標參數指定建築物在緯度、經度及 (可選) 高度座標中的位置。 此參數的有效值可使用以下格式之一：

• 緯度與經度：例如，「47.644125;-122.122411」
• 緯度、經度與高度：例如，「47.644125;-122.122411;161.432"

-DisplayName

DisplayName 參數指定該地點的顯示名稱。 最大長度為200字元。

建築物的展示名稱可見：

• 在 Outlook 中，使用者設定工作時間和地點時，可以選擇建築物。
• 在 Places Explore 頁面，顯示同一棟建築裡還有誰、附近的建築物等等。
• 在 Places Finder 中，作為搜尋會議室或工作空間的篩選工具。

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

-ParentId

ParentId 參數指定 Microsoft Places 中父位置階層中 Place 的 ID。

• 房間應該有家長樓層或區域。
• 工作區或書桌應該有一個父區。
• 一個區塊應該有母樓層。
• 樓層應該有母樓。

-郵遞區號

郵遞區號參數指定該建築的郵遞區號。 最大長度為200字元。

-資源連結

ResourceLinks 參數指定應與此建築相關聯的外部連結或 Teams 應用程式 ID，例如餐飲菜單、服務連結或用於訪客管理的 Teams 應用程式。 欲了解更多如何在 Places 設置服務的資訊，請參閱 Services in Places。

該值必須以連結陣列形式提供，如 範例 4 所示。 每個連結應包含以下屬性：名稱、價值與類型。  例如，連結會寫成 @{name=“TestLink”; value=“https://contoso.com/"; type=”Url“}。

• 名稱
  • 這個字串用來顯示你的連結或應用程式名稱在 Places 應用程式中的顯示方式。
  • 最大長度為200字元。
• 值
  • 這個值應該是 URL 連結或 Teams 應用程式 ID。 Teams 應用程式 ID 可在 Teams 管理中心的 「管理應用程式 」頁面的應用程式細節頁面找到。
  • 最大長度為 1000 字元。
• 類型 必須是支援型態之一：
  • 網址 - 表示這是一個網址連結。
  • MetaOsApp - 表示此連結為 Teams 應用程式。

-排序

SortOrder 參數指定樓層的排序順序。 例如，某層樓可能命名為「大廳」，排序順序為 0，以便在有序清單中顯示該樓層。

-州

州參數指定建築的州或省份。 最大長度為200字元。

-街道

街道參數指定建築物的實體地址。 最大長度為200字元。

-標籤

Tags 參數會指定房間的其他特徵，例如 (景觀類型或家具類型) 。 目前沒有上限長度。

你可以指定多個標籤，並用逗號分隔。 若標籤包含空格，則以引號包圍這些值： "Label 1","Label 2",..."Label N"。

-方式

模式參數定義了場地的使用或預訂方式。 目前，模式僅適用於辦公桌與辦公桌池 (工作區) 。

目前共有四種模式。

• 可預訂-可預訂的桌子是設定成可提前或當場預訂的桌子。
• 臨時使用-櫃台可即時使用，且無法事先預約。 你可以利用 Microsoft Teams 的功能，將這些桌上的周邊裝置連結到目錄中的個別桌上物件。
• 分配 - 分配的座位會永久綁定給特定使用者，不能被其他人預約。 每個分配的桌子都必須有指定的使用者。
• 無法使用-因維修或其他原因，櫃檯無法預約。

模式值應包含以下屬性：名稱與元資料，如 範例 5 所示。 名稱是字串，元資料是字典物件。

• 名稱：名稱欄位指定該地點的活動模式。 它使用一個列舉值，且可用的選項會依地段類型而異。 對於桌面，支援的模式包括Reservable、、 Drop-InAssignedUnavailable和 。 對於桌上池，支援的模式為 Reservable、 和 Drop-InUnavailable。

• 元資料：元資料欄位是一個字典，用來儲存與所選模式相關的額外資訊。 這些元資料支援與特定預訂情境相關的商業邏輯。

  • Places 在可保留和 Drop-In 模式下不支援任何元資料欄位。
  • Places在不可用模式下支援Reason一個欄位 (字串) ，解釋為何該書桌不可用。 這些數值包括New新製作的辦公桌及Maintenance正在服務的 Places。
  • 指派模式支援兩個元資料欄位： AssignedPersonEmailAddress 和 AssignedPersonId。 這些資料會識別分配到該桌的使用者。 只要任一欄位足夠啟用指定模式即可。

-Type

型態參數指定正在建立的場所的型別。 有效值為：

• 建築物
• Floor
• 區段
• 會議室
• 工作區
• 桌