共用方式為


Set-PlaceV3

使用 Set-PlaceV3 Cmdlet 來更新您 Places 目錄內的會議室、工作區、樓層或建築物的相關元數據。

注意事項

  • 匯報 至會議室 & 工作區最多可能需要 24 小時的時間來反映。 如果您需要將多個會議室和工作區上線,建議您使用 Initialize-Places,這可以強制立即反映變更。
  • Set-UserPhoto 在2024年4月 已被取代 。 我們正努力將參數新增至此 Cmdlet,以在使用 Set-PlaceV3 時,在會議室和工作區上設定相片。 在此同時,請遵循 這些指示 ,在會議室或工作區上設定相片。

語法

建築物

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

Floor

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

區段

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

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

書桌

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

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

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-Name]
 [-Tags]
 [-Mailbox]

會議室或工作區

Set-PlaceV3 支援已在 Exchange Set-Place Cmdlet 中公開的舊版位置參數。 不過,一旦會議室使用 -ParentId 參數連結到樓層/建築物, (StreetCity等 ) 的位置資訊應該在建築物上管理,而不是在會議室或工作區上管理。

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-Building]
 [-Floor]
 [-FloorLabel]
 [-Tags]

描述

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

此範例會建立桌面信箱,並將它指派給現有的桌面實體。 請注意,您必須先安裝 ExchangeOnlineManagement 模組並執行 Cmdlet Connect-ExchangeOnline ,才能執行下列動作:

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias

參數

-Identity

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

例如,針對以信箱 (會議室和工作區為基礎的地點) :

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 標準 DN
  • GUID

例如,對於不是以信箱為基礎的地方, (建築物、樓層、區段和桌面) :

  • 名稱
  • GUID
屬性 描述
類型: RecipientIdParameter
位置: 0
預設值:
必填:
接受管線輸入: True
接受通配符:

-AudioDeviceName、-DisplayDeviceName 和 VideoDeviceName

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

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-建築

重要事項

建置參數已被取代,並在此提供僅供回溯相容性使用。 系統會從位於會議室或工作區父鏈結上的 Building 實體讀取建置資訊。

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-能力

Capacity 參數會指定房間的容量。 有效值為整數。

屬性 描述
類型: System.Int32
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-城市

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

我們建議您管理建築物上的位置數據,而不是會議室/工作區。 會議室 - 樓層 ->> 建築物和會議室之間有一個階層,而會議室會繼承其 Building 的位置屬性。

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-CountryOrRegion

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

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

我們建議您管理建築物上的位置數據,而不是會議室/工作區。 會議室 - 樓層 ->> 建築物和會議室之間有一個階層,而會議室會繼承其 Building 的位置屬性。

屬性 描述
類型: CountryInfo
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-Label

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

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入: True
接受通配符:

-DisplayDeviceName

DisplayDeviceName 參數會指定會議室中顯示設備的名稱。 如果值包含空格,請使用引號 (") 括住值。

預設值為空白 ($null)。 若要指出此會議室沒有顯示設備,請使用此參數$null值。

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-FloorLabel

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-地板

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

屬性 描述
類型: System.Int32
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-GeoCoordinates

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

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

如果期間分隔符不適用於您,請改用逗號。

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

屬性 描述
類型: GeoCoordinates
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-IsWheelChairAccessible

IsWheelChairAccessible 參數會指定該地點是否可無障礙。 有效值為:

  • $true:此地點是無障礙的地方。
  • $false:此地點無法無障礙地存取。 這是預設值。
屬性 描述
類型: 布林值
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-MTREnabled

注意事項

目前,此參數僅供資訊使用,不會產生其他功能。

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

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

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

屬性 描述
類型: 布林值
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-DisplayName

DisplayName 參數會指定位置的顯示名稱。 最大長度為 200 個字元。 Set-PlaceV3 只能更新沒有相關聯 SMTP 位址的地方名稱,例如建築物和樓層。 若要更新具有相關聯 SMTP 位址的位置顯示名稱,例如會議室和工作區,請使用 Exchange Set-Mailbox Cmdlet

屬性 描述
類型: 字串
預設值:
必填: True
接受管線輸入:
接受通配符:

-ParentId

ParentId 參數會指定 Microsoft Places 中父位置階層中 Place 的標識碼。 房間應該有父樓層或區段。 工作區或桌面應具有父區段。 區段應該具有父樓層。 樓層應該有父建築物。

注意事項

如果您需要與 Outlook Roomfinder 的回溯相容性,請務必同時更新 “Floor”/“FloorLabel” 屬性,同時將會議室設為樓層實體。 Places Finder 會使用新的階層,而 Outlook Roomfinder 會持續使用舊版的 “Floor” 和 “FloorLabel” 物件。 您也必須確定會議室與 Roomlist 相關聯,如這裡為 Outlook 中的會議室尋找程式設定會議室和工作區所述。

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-PostalCode

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

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

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

  • 名稱

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

    • 最大長度為 200 個字元。

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

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

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

    • URL - 指出這是 URL 連結。

    • MetaOsApp - 指出此連結是 Teams 應用程式。

注意事項

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

屬性 描述
類型: Link[]
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-SortOrder

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

屬性 描述
類型: System.Int32
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-州

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

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-街

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

我們建議您管理建築物上的位置數據,而不是會議室/工作區。 會議室 - 樓層 ->> 建築物和會議室之間有一個階層,而會議室會繼承其 Building 的位置屬性。

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

-標籤

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

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

注意事項

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

屬性 描述
類型: 字串
位置:
預設值:
必填:
接受管線輸入:
接受通配符:

疑難排解

我收到許可權遭拒錯誤。

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

  • 如果許可權是透過僅支援永久許可權) 的 Exchange 管理員 Center (來指派,則使用 Places Cmdlet 應該沒有任何問題。 您不會看到「許可權遭拒」錯誤。
  • 如果透過 Entra 直接將許可權指派給使用者, (作為永久或暫時角色) ,則使用 Places Cmdlet 應該沒有任何問題。 您不會看到「許可權遭拒」錯誤。 不過,Entra 與 Exchange 之間的同步可能會有一些延遲。
  • 如果透過 Entra 將許可權指派給用戶所屬的 Entra 群組,則 Exchange 不支援此許可權,且不會遵守角色對群組。 Exchange Cmdlet 和 Places Cmdlet 都會因為許可權遭拒而失敗。 此 處會描述此預期的行為。

我已將 ParentId 指派給資源,但尚未在 [Places Finder 中看到它。

資源與其父 Floor 之間的相互關聯最多可能需要 24 小時才會出現在 Places 體驗中。 我們正努力消除此延遲。

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

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

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