Set-PlaceV3

使用 Set-PlaceV3 Cmdlet 來更新 Places 目錄中關於辦公桌、會議室、工作區、區段、樓層或建築物的中繼資料。

注意事項

  • 建議更新至 Places PowerShell 2.0.0 版及更新版本,以確保存取最新功能和改良功能。
  • 在 Exchange 混合式環境中, Set-PlaceV3 Cmdlet 無法用來更新同步處理會議室信箱上的下列屬性:City、CountryOrRegion、GeoCoordinates、Phone、PostalCode、State 和 Street。 此外,您無法在同步處理的會議室信箱上設定地理座標。 若要設定其他屬性,請使用 Set-User 內部部署 Exchange 中的 Cmdlet Set-Mailbox 或 Cmdlet。
  • 會議室 & 工作區的匯報最多可能需要 24 小時才能反映。 如果您需要上線多個會議室和工作區,我們建議您使用 Initialize-Places,它能夠強制立即反映變更。
  • 該 Set-UserPhoto Cmdlet 已於 2024 年 4 月 淘汰 。 我們正在努力新增參數 Set-PlaceV3 ,以在會議室和工作區上設定相片。 目前,請移至 [在 Microsoft Entra 系統管理中心] 新增或更新使用者的設定檔資訊和設定,以在會議室或工作區上設定相片。

語法

建築物

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

Floor

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

區段

橫斷面是樓層內空間的群組,例如,社區。 辦公桌和工作區必須為區段的父級。 房間也可以選擇性地設定為區段的父級,也可以直接為樓層的父級。

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]

辦公桌

辦公桌是 Microsoft Places 中新引進的實體類型,代表個別辦公桌單位。 每個辦公桌都有一個 Mode 屬性,可指定如何預約辦公桌。 如需詳細資訊,請參閱下方的模式章節。

對於辦公桌,模式和信箱設定之間存在以下相依性:

  • 如果未定義 [模式] 屬性,則辦公桌預設為 [不可用],且不會自動建立任何辦公桌信箱。
  • 對於設定為可保留或 DropIn 模式的辦公桌,需要辦公桌信箱。 佈建辦公桌時,會自動建立一個。 或者,您可以在 Mailbox 參數中指定 EmailAddress 來連結現有的信箱。
  • 對於處於 [已指派] 或 [不可用] 模式的辦公桌,可選擇是否要連結信箱,而且預設不會建立任何信箱。 不過,如果需要,您可以手動將這些辦公桌與自訂信箱建立關聯。
  • 如果最初未設定任何模式,辦公桌將保持不可用模式。 之後連結信箱不會自動更新辦公桌的模式。

與會議室或工作區類型不同,辦公桌不會透過簡單地建立信箱來自動佈建。 此外,容量或 DisplayName 等中繼資料不會與信箱屬性同步。 信箱主要由保留引擎使用,而中繼資料則是從 Places Directory 讀取。

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

會議室

Set-PlaceV3 支援 Exchange Set-Place Cmdlet 中已有的舊版位置參數。 不過,使用參數將 -ParentId 會議室連結至樓層或建築物後,位置詳細資料 (Street 和 City) 應在建築物層級進行管理,而非在個別會議室或工作區上進行管理。

注意事項

系統會忽略會議室或工作區信箱物件上設定 (Street、City、State、CountryOrRegion 和 PostalCode) 地址欄位。

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

工作區

Set-PlaceV3 支援 Exchange Set-Place Cmdlet 中已有的舊版位置參數。 但是,使用該參數將 -ParentId 工作區連結至剖面後,位置詳細資料 (Street 和 City) 應在建築層級進行管理,而非在個別會議室或工作區上進行管理。

注意事項

系統會忽略會議室或工作區信箱物件上設定 (Street、City、State、CountryOrRegion 和 PostalCode) 地址欄位。

Workspace 支援 Mode 屬性。 相同的詳細資訊記錄在參數部分。-Mode

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

描述

Places 取決於您的會議室/工作區、樓層和建築物之間完整設定的階層。 建立建築物和樓層之後,您可以使用 parentId 連結它們。 會議室應具有父樓層或區域。 工作區或辦公桌應該有上層區段。 區段應該有父樓層。 樓層應具有父建築物。

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

注意

您可能會在 PowerShell Cmdlet 中找到額外的參數,但目前不支援這些參數。 請勿使用本頁未記載的任何參數。

範例

範例 1

此範例會設定會議室、樓層和建築物的目錄階層。

在此範例中,樓層的 PlaceId 為 f12172b6-195d-4e6e-8f4f-eb72e41de99a,而建築物的 PlaceId 為 daa2f89b-75c4-4eb7-adcc-ff249233338d。

Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d

範例 2

此範例會更新建築物的地址。

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

範例 3

此範例會更新建築物的地理座標。

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"

範例 4

此範例使用資源連結更新建築物的資源連結。 整組會在更新時取代。 若要新增或移除值,請務必包含應該保留的先前值。

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

範例 5

此範例會在區段下建立可保留的辦公桌,而不指定信箱詳細資料。 系統會自動建立並連結桌面信箱,並填入 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'}

範例 6

此範例會將模式值更新為 DropIn 模式。

Set-PlaceV3 -Identity <DeskOrWorkspacePlaceId> -Mode @{Name='DropIn'}

範例 7

此範例會將模式值更新為指派模式。

請注意,即使辦公桌已是指派模式辦公桌,變更也只是中繼資料欄位。 需要建立一個全新的模式物件並取代舊物件。

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity <DeskPlaceId> -Mode @{Name='Assigned';Metadata=$modemetadata}

參數

-Identity

identity 參數會指定要更新的位置。 您可以使用唯一識別地點的任何值。

例如,對於以信箱為基礎的位置 (會議室和工作區) :

  • 名稱 [已取代]
  • 別名 [已取代]
  • DN) (辨別名稱 [已取代]
  • 正式 DN [已取代]
  • GUID [已取代]
  • 電子郵件地址

例如,對於不是以信箱為基礎 (建築物、樓層、區段和辦公桌的位置,) :

  • 名稱
  • GUID
屬性 描述
類型: RecipientIdParameter
職位: 0
預設值: 無
必要項目: 錯
接受管線輸入: True
接受萬用字元: 錯

-AudioDeviceName 和 -VideoDeviceName

這些參數指定會議室中音訊和視訊裝置的名稱。 如果值包含空格,請使用引號 (") 括住值。

預設值為空白 ($null)。 若要指出此會議室沒有音訊或視訊裝置,請使用值 $null 作為參數。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-建築

重要事項

建置參數已過時,並提供這裡僅供回溯相容性。 建築資訊將從位於會議室或工作區父鏈上的建築實體讀取。

Building 參數會指定會議室所在的建築物名稱或建築物編號。 如果值包含空格,請使用引號 (") 括住值。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-容量

Capacity 參數會指定會議室或工作區的容量。 有效值為整數。

注意事項

  • Set-PlaceV3 Cmdlet 會更新會議室和工作區之同步處理信箱上的下列屬性:容量和名稱。 若要設定這些屬性,您需要 Place 系統管理員角色或全域管理員角色權限。
屬性 描述
類型: System.Int32
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-城市

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

提示

會議室/工作區 -> 樓層 -> 建築物之間存在階層,而會議室/工作區會繼承其建築物的位置屬性。 對於有上層的會議室和工作區,城市資訊將被忽略。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-CountryOrRegion

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

國家 /地區代碼清單中提供了兩個字母國家/地區代碼的參考。

提示

會議室/工作區 -> 樓層 -> 建築物之間存在階層,而會議室/工作區會繼承其建築物的位置屬性。 對於有父層的會議室和工作區,將忽略 CountryOrRegion 資訊。

屬性 描述
類型: CountryInfo
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-Label

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

針對會議室和工作區,此命令會更新 Exchange Set-Place 中名為 -Label 的值。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: True
接受萬用字元: 錯

-DisplayDeviceName

DisplayDeviceName 參數會指定會議室、桌面或工作區) 位置 (顯示裝置名稱。 如果值包含空格,請使用引號 (") 括住值。

預設值為空白 ($null)。 若要表示此位置沒有顯示裝置,請使用此參數的值$null。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-FloorLabel

FloorLabel 參數會指定樓層的描述性標籤。 如果值包含空格,請使用引號 (") 括住值。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-地板

樓層參數會指定特定建築物內樓層的排序順序。

屬性 描述
類型: System.Int32
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-地理坐標

GeoCoordinates 參數可指定建築物的緯度、經度和 ((可選) 高度座標)。 此參數的有效值使用下列其中一種格式:

  • 緯度和經度:例如 “47.644125;-122.122411”
  • 緯度、經度和高度:例如,“47.644125;-122.122411;161.432"

如果句號分隔符號不起作用,請改用逗號。

提示

我們建議您在建築物上管理位置資料,而不是在會議室/工作區上管理位置資料。 會議室/工作區 -> 樓層 -> 建築物之間存在階層,而會議室/工作區會繼承其建築物的位置屬性。

屬性 描述
類型: 地理座標
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-IsWheelchair無障礙設施

IsWheelChairAccessible 參數會指定該地點是否可供輪椅使用者使用。 有效值為:

  • $true:這個地方可以輪椅通行。
  • $false:這個地方不適合輪椅使用者。 這是預設值。
屬性 描述
類型: 布林值
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-MTREnabled

MTREnabled 參數會識別會議室是否設定了 Microsoft Teams 會議室系統。 您可以在涉及會議室的 Teams 會議中,將 Teams 會議室系統新增為音訊來源。 有效值為:

  • $true:會議室有 Teams 會議室系統。 當您選取以會議室音訊加入會議時,可以將 Teams 會議室系統新增至 Microsoft Teams 會議。
  • $false:會議室沒有 Teams 會議室系統。 使用者可以使用其電腦或行動裝置音訊,而非使用會議室音訊加入 Teams 會議。 這是預設值。

如需有關 Microsoft Teams 會議室的詳細資訊,請參閱 Microsoft Teams 會議室。

屬性 描述
類型: 布林值
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-DisplayName

DisplayName 參數會指定位置的顯示名稱。 最大長度為 200 個字元。 若要更新具有相關聯 SMTP 位址的會議室或工作區位置的顯示名稱,您需要位置管理員、Exchange 管理員或全域管理員角色。

屬性 描述
類型: 字串
預設值: 無
必要項目: True
接受管線輸入: 錯
接受萬用字元: 錯

-ParentId

ParentId 參數會指定 Microsoft Places 中上層位置階層中位置的識別碼。 會議室應具有父樓層或區域。 工作區或辦公桌應該有上層區段。 區段應該有父樓層。 樓層應具有父建築物。

注意事項

如果您需要與 Outlook Roomfinder 的回溯相容性,請務必同時更新 “Floor”/“FloorLabel” 屬性,同時將會議室設定為樓層實體的父系。 Places Finder 會使用新的階層,而 Outlook Roomfinder 會繼續使用舊版的 “Floor” 和 “FloorLabel” 物件。 您也需要確認會議室已與會議室清單相關聯,如此所述: 在 Outlook 中設定會議室尋找工具的會議室和工作區。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-郵遞區號

PostalCode 參數會指定建築物的郵遞區號。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

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

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

  • 名稱

    • 此字串用於顯示您的連結或應用程式名稱在 Places 應用程式中的顯示方式。

    • 最大長度為 200 個字元。

  • 值

    • 此值應該是 URL 連結或 Teams 應用程式識別碼。 您可以在 Teams 系統管理中心 [ 管理應用程式 ] 頁面中的應用程式詳細資料頁面中找到 Teams 應用程式識別碼。

    • 最大長度為 1,000 個字元。

  • 類型 必須是其中一種支援的類型:

    • Url - 表示這是 URL 連結。

    • MetaOsApp - 表示此連結是 Teams 應用程式。

注意事項

整組將會在更新時取代。 若要新增或移除值,請務必包含應該保留的先前值。

屬性 描述
類型: 連結[]
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-SortOrder

SortOrder 參數會指定樓層的排序順序。 例如,可以將某個樓層命名為「大廳」,並讓排序順序為 0,以在已排序清單中第一個顯示該樓層。

屬性 描述
類型: System.Int32
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-State

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

提示

會議室/工作區 -> 樓層 -> 建築物之間存在階層,而會議室/工作區會繼承其建築物的位置屬性。 對於有父級的會議室和工作區,將忽略狀態資訊。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-街道

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

提示

會議室/工作區 -> 樓層 -> 建築物之間存在階層,而會議室/工作區會繼承其建築物的位置屬性。 對於有父層的會議室和工作區,將忽略街道資訊。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-Mode

Mode 參數定義了如何使用或預訂地點。 目前,該模式僅適用於辦公桌和辦公桌集區 (工作區) 。

目前總共有四種模式。

  • 可預訂- 可預訂辦公桌是配置為提前或現場預訂的辦公桌。
  • DropIn- 辦公桌可供現場使用,無法提前預訂。 您可以使用 Microsoft Teams 的功能,將這些辦公桌上現有的周邊裝置連結至目錄中的個別辦公桌物件。
  • 已指派 - 指派的desk 會永久連結到特定使用者,且無法由其他人預約。 每個指派的辦公桌必須始終具有指定的使用者。
  • 不可用 - 由於維護或任何其他原因,辦公桌無法預訂。

Mode 值包含 Name 屬性,對於支援它的模式,還包含中繼資料字典。 請參閱 範例 7 以取得包含中繼資料的指派模式範例。

  • 名稱:[名稱] 欄位會指定位置的作用中模式。 它使用列舉值,可用選項因位置類型而異。 對於辦公桌,支援的模式包括 Reservable、 DropIn和 AssignedUnavailable。 對於桌面集區,支援的模式為 Reservable和 DropInUnavailable。

  • 中繼資料:中繼資料欄位是用來儲存與所選模式相關的其他資訊的字典。 此中繼資料支援與特定預約案例相關的商務邏輯。

    • Retentable 和 DropIn 模式中的 Places 不支援任何中繼資料欄位。
    • 無法使用模式的Places支援一個Reason欄位 (字串) ,說明辦公桌無法使用的原因。 值包括New新建立的辦公桌和Maintenance正在進行服務之 Places。
    • 指派模式支援兩個中繼資料欄位: AssignedPersonEmailAddress 和 AssignedPersonId。 這些識別指派給桌面的使用者。 提供任一欄位,就足以啟用指派模式。
屬性 描述
類型: Mode
職位: 已命名
預設值: @{name='不可用', metadata={'reason':'new'}}
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

-標籤

標籤參數可指定會議室的其他功能 (例如,視圖類型或傢俱類型) 等詳細資料。 目前沒有長度上限。

您可以指定多個標籤,以逗號分隔。 如果標籤包含空格,請將值括在引號中: "Label 1","Label 2",..."Label N"。

注意事項

整組將會在更新時取代。 若要新增或移除值,請務必包含應該保留的先前值。

屬性 描述
類型: 字串
職位: 已命名
預設值: 無
必要項目: 錯
接受管線輸入: 錯
接受萬用字元: 錯

疑難排解

我收到權限遭拒的錯誤。

Set-PlaceV3 需要下列其中一個角色:TenantPlacesManagement、GlobalAdmin 或 MailRecipients。 由於角色可以以不同的方式指派,以下是支援指派角色權限的方式:

  • 如果權限是透過 Exchange 管理員中心指派的, (該中心僅支援永久) ,則使用 Places Cmdlet 應該不會有問題。 您不會看到權限遭拒錯誤。
  • 如果權限是透過 Entra 直接指派給使用者 (永久或暫時角色) ,則使用 Places Cmdlet 應該不會有問題。 您不會看到權限遭拒錯誤。 不過,Entra 和 Exchange 之間的同步可能會有一些延遲。
  • 如果透過 Entra 將權限指派給使用者所屬的 Entra 中的群組,則 Exchange 不支援此功能,且不會尊重角色透過群組。 Exchange Cmdlet 和 Places Cmdlet 都會失敗,且權限遭拒。 這裡說明此預期行為。

我已將 ParentId 指派給資源,但我還沒有在 Places Finder 中看到它。

資源與其上層樓層之間的相互關聯最多可能需要 24 小時,才能在 Places 體驗中顯示。 我們正努力消除此延遲。

如何?在資源上設定相片?

此 Set-UserPhoto 已於 2024 年 4 月 淘汰 。 我們正在努力為此 Cmdlet 新增一個參數,以便在使用 Set-PlaceV3 時在會議室和工作區上設定相片。 同時,請遵循 下列指示 ,在會議室或工作區上設定相片。

目前無法將相片設定在建築物或樓層上。