Set-PlaceV3
使用 Set-PlaceV3 Cmdlet 來更新您 Places 目錄內的會議室、工作區、樓層或建築物的相關元數據。
注意事項
語法
建築物
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
傳遞至 Mailbox
的 Set-PlaceV3
參數,以將它與桌面對象產生關聯。 請注意,不同於會議室/工作區類型,桌面不會透過單獨建立信箱來隱含布建。 此外,元數據 (例如 Capacity
或 DisplayName
字段) 不會與信箱元數據保持同步。 信箱主要是保留引擎的必要專案,而且會從 Places Directory 讀取元數據。
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
會議室或工作區
Set-PlaceV3 支援已在 Exchange Set-Place Cmdlet 中公開的舊版位置參數。 不過,一旦會議室使用 -ParentId
參數連結到樓層/建築物, (Street
、 City
等 ) 的位置資訊應該在建築物上管理,而不是在會議室或工作區上管理。
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
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 時,在會議室和工作區上設定相片。 在此同時,請遵循 下列指示 ,在會議室或工作區上設定相片。
目前無法在建築物或樓層上設定相片。