Set-Place
此指令程式只能在雲端式服務中使用。
使用 Set-Place Cmdlet 以額外的元數據更新會議室信箱,以提供更好的搜尋和會議室建議體驗。
注意:在混合式環境中,此 Cmdlet 無法在同步處理的會議室信箱上使用下列屬性:City、CountryOrRegion、GeoCoordinates、Phone、PostalCode、State 或 Street。 若要修改這些屬性 (同步會議室信箱) 上的 GeoCoordinates 除外,請使用內部部署 Exchange 中的 Set-User 或 Set-Mailbox Cmdlet。
注意:建議您搭配EXO V3模組使用此 Cmdlet。 在舊版模組中,使用 Set-Place 一起變更特定屬性組合的命令可能會失敗。 如需EXO V3模組的詳細資訊,請參閱關於 Exchange Online PowerShell 模組。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-Place
[-Identity] <RecipientIdParameter>
[-AudioDeviceName <String>]
[-Building <String>]
[-Capacity <System.Int32>]
[-City <String>]
[-Confirm]
[-CountryOrRegion <CountryInfo>]
[-DisplayDeviceName <String>]
[-Floor <System.Int32>]
[-FloorLabel <String>]
[-GeoCoordinates <GeoCoordinates>]
[-IsWheelChairAccessible <Boolean>]
[-Label <String>]
[-MTREnabled <Boolean>]
[-ParentId <String>]
[-ParentType <Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType>]
[-Phone <String>]
[-PostalCode <String>]
[-State <String>]
[-Street <String>]
[-Tags <String[]>]
[-VideoDeviceName <String>]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果某些參數未包含在指派給您的許可權中,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-Place -Identity "Conference Room 01" -IsWheelChairAccessible $true -AudioDeviceName PolyCom -DisplayDeviceName "InFocus WXGA Projector"
此範例會將指定的元數據新增至名為會議室 01 的會議室信箱。
範例 2
Set-Place -Identity "Conference Room 02" -Building "Building 02" -Capacity 5 -CountryOrRegion ES -Floor 3 -FloorLabel "Human Resources" -Label Interviews
此範例會將指定的元數據新增至名為會議室 02 的會議室信箱。
參數
-AudioDeviceName
適用:Exchange Online
AudioDeviceName 參數會指定會議室中的音訊裝置名稱。 如果值包含空格,請使用引號 (") 括住值。
預設值為空白 ($null)。 若要指出此會議室沒有音訊裝置,請使用此參數$null值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Building
適用:Exchange Online
Building 參數會指定房間所在的建築物名稱或建築物編號。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Capacity
適用:Exchange Online
Capacity 參數會指定房間的容量。 有效值為整數。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-City
適用:Exchange Online
City 參數會指定會議室的城市。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Online
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CountryOrRegion
適用:Exchange Online
CountryOrRegion 參數會指定會議室的國家或地區。 有效的值是有效的 ISO 3166-1 兩個字母的國家/地區代碼 (例如,澳大利亞) 的 AU,或與官方 ISO 3166 維護機構簡短名稱) 不同的國家/地區 (對應的易記名稱。
兩個字母的國家/地區代碼參考可在國家/ 地區代碼清單取得。
Get-Place Cmdlet 會在 CountryOrRegion 屬性值中傳回易記名稱,但您可以在篩選作業中使用易記名稱或兩個字母的國家/地區代碼。
參數屬性
| 類型: | CountryInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayDeviceName
適用:Exchange Online
DisplayDeviceName 參數會指定會議室中顯示設備的名稱。 如果值包含空格,請使用引號 (") 括住值。
預設值為空白 ($null)。 若要指出此會議室沒有顯示設備,請使用此參數$null值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Floor
適用:Exchange Online
Floor 參數會指定房間所在的樓層編號。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FloorLabel
適用:Exchange Online
FloorLabel 參數會為房間所在的樓層指定描述性標籤。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GeoCoordinates
適用:Exchange Online
GeoCoordinates 參數會指定房間在緯度、經度和 (選擇性地) 高度座標的位置。 此參數的有效值會使用下列其中一種格式:
- 緯度和經度:例如,“47.644125;-122.122411”
- 緯度、經度和高度:例如,「47.644125;-122.122411;161.432"
注意:如果期間分隔符不適用於您,請改用逗號。
參數屬性
| 類型: | GeoCoordinates |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Online
Identity 參數會指定您要修改的會議室信箱。 您可以使用可唯一識別房間的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
參數屬性
| 類型: | RecipientIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IsWheelChairAccessible
適用:Exchange Online
IsWheelChairAccessible 參數會指定房間是否可無障礙。 有效值為:
- $true:房間是無障礙的。
- $false:會議室無法無障礙。 此值為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Label
適用:Exchange Online
Label 參數會指定房間 (的描述性標籤,例如數位或名稱) 。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MTREnabled
適用:Exchange Online
注意:目前,此參數僅供資訊使用,不會產生其他功能。
MTREnabled 參數會識別使用 Microsoft Teams 會議室系統所設定的會議室。 您可以在涉及會議室的 Teams 會議中,將 Teams 會議室系統新增為音訊來源。 有效值為:
- $true:會議室具有Teams會議室系統。 您可以在選取加入會議室音訊會議時,將 Teams 會議室系統新增至Microsoft Teams 會議。
- $false:會議室沒有 Teams 會議室系統。 使用者使用其電腦或行動裝置音訊加入 Teams 會議,而不是使用會議室音訊。 此值為預設值。
如需 Microsoft Teams 會議室 的詳細資訊,請參閱 Microsoft Teams 會議室。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ParentId
適用:Exchange Online
注意:這項功能是實驗性的,僅適用於使用 Microsoft Places 的組織。
ParentId 參數會在 Microsoft Places 的父位置階層中指定 Place 的識別碼。
將會議室和工作區上線以 Microsoft Places 的組織必須在 Set-Place 命令中使用 ParentId 和 ParentType 參數,Microsoft Places 才能正常運作。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ParentType
適用:Exchange Online
注意:這項功能是實驗性的,僅適用於使用 Microsoft Places 的組織。
ParentType 參數會在 Microsoft Places 中指定ParentId的父類型。 有效值為:
- Floor
- 區段
將會議室和工作區上線以 Microsoft Places 的組織必須在 Set-Place 命令中使用 ParentId 和 ParentType 參數,Microsoft Places 才能正常運作。
參數屬性
| 類型: | Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Phone
適用:Exchange Online
Phone 參數會指定房間的電話號碼。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PostalCode
適用:Exchange Online
PostalCode 參數會指定房間的郵遞區編碼。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-State
適用:Exchange Online
State 參數會指定房間的州或省。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Street
適用:Exchange Online
Street 參數會指定會議室的實體位址。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tags
適用:Exchange Online
Tags 參數會指定房間 (的其他功能,例如,如檢視類型或) 的房間類型等詳細數據。
您可以指定多個以逗號分隔的標籤。 如果標籤包含空格,請以引弧括住值: "Label 1","Label 2",..."Label N"。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-VideoDeviceName
適用:Exchange Online
VideoDeviceName 參數會指定會議室中視訊裝置的名稱。 如果值包含空格,請使用引號 (") 括住值。
預設值為空白 ($null)。 若要指出此會議室沒有視訊裝置,請使用此參數$null值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Online
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。