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 目录中读取。
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 链接它们。 房间应具有父楼层或分区。 工作区或桌面应具有父分区。 节应具有父级下限。 楼层应具有父级建筑。
您必须先获得权限，然后才能运行此 cmdlet。 必须具有 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 模块并运行 Connect-ExchangeOnline cmdlet：
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
参数
-Identity
标识参数指定要更新的位置。 可以使用唯一标识位置的任何值。
例如，对于基于邮箱的位置 (会议室和工作区) ：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
例如，对于不基于邮箱 (建筑物、楼层、分区和办公桌的位置) ：
- 名称
- GUID
| 属性 | 说明 |
|---|---|
| 类型： | RecipientIdParameter |
| 位置： | 0 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | True |
| 接受通配符： | False |
-AudioDeviceName、-DisplayDeviceName 和 VideoDeviceName
这些参数指定会议室中音频、显示器和视频设备的名称。 如果值中有空格，请使用双引号 (") 将此值括起来。
默认值为空 ($null)。 若要指示此会议室没有音频、显示器或视频设备，请使用 参数$null值。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-建筑
重要
此处提供的生成参数已弃用，仅用于向后兼容。 将从会议室或工作区的父链上的 Building 实体读取建筑物信息。
Building 参数指定房间位于的建筑名称或建筑物编号。 如果值中有空格，请使用双引号 (") 将此值括起来。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-能力
Capacity 参数指定会议室的容量。 有效值是一个整数。
| 属性 | 说明 |
|---|---|
| 类型： | System.Int32 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-城市
City 参数指定建筑物的城市。 如果值中有空格，请使用双引号 (") 将此值括起来。 最大长度为 200 个字符。
建议管理建筑物（而不是会议室/工作区）上的位置数据。 房间 （ 楼层 ->> 建筑物）之间存在层次结构，会议室继承其 Building 的位置属性。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-CountryOrRegion
CountryOrRegion 参数指定建筑物的国家或地区。 有效值是有效的 ISO 3166-1 双字母国家/地区代码 (例如，澳大利亚的 AU) 或国家/地区 (的相应友好名称，这可能不同于官方的 ISO 3166 维护机构短名称) 。
国家/地区代码列表中提供了双字母国家/ 地区代码的参考。
建议管理建筑物（而不是会议室/工作区）上的位置数据。 房间 （ 楼层 ->> 建筑物）之间存在层次结构，会议室继承其 Building 的位置属性。
| 属性 | 说明 |
|---|---|
| 类型： | CountryInfo |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-Label
Label 参数指定位置的描述性标签。 如果值中有空格，请使用双引号 (") 将此值括起来。 最大长度为 200 个字符。
对于会议室和工作区，命令更新 Exchange Set-Place 中名为 -Label 的值。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | True |
| 接受通配符： | False |
-DisplayDeviceName
DisplayDeviceName 参数指定会议室中显示设备的名称。 如果值中有空格，请使用双引号 (") 将此值括起来。
默认值为空 ($null)。 若要指示此会议室没有显示设备，请使用此参数$null值。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-FloorLabel
FloorLabel 参数指定楼层的描述性标签。 如果值中有空格，请使用双引号 (") 将此值括起来。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-地板
Floor 参数指定特定建筑物中楼层的排序顺序。
| 属性 | 说明 |
|---|---|
| 类型： | System.Int32 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-GeoCoordinates
GeoCoordinates 参数指定建筑物的纬度、经度和 (位置（可选) 海拔坐标）。 此参数的有效值使用以下格式之一：
- 纬度和经度：例如，“47.644125;-122.122411”
- 纬度、经度和高度：例如“47.644125;-122.122411;161.432"
如果句点分隔符不起作用，请改用逗号。
建议管理建筑物（而不是会议室/工作区）上的位置数据。 房间 （ 楼层 ->> 建筑物）之间存在层次结构，房间的 将继承其 Building 的位置属性。
| 属性 | 说明 |
|---|---|
| 类型： | GeoCoordinates |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-IsWheelChairAccessible
IsWheelChairAccessible 参数指定位置是否适合轮椅。 有效值包含:
- $true：这个地方适合轮椅使用者。
- $false：这个地方不适合轮椅使用者。 此值为默认值。
| 属性 | 说明 |
|---|---|
| 类型： | 布尔值 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-MTREnabled
注意
目前，此参数仅供信息使用，不产生其他功能。
MTREnabled 参数标识使用 Microsoft Teams 会议室系统配置的会议室。 可以在涉及会议室的 Teams 会议中添加 Teams 会议室系统作为音频源。 有效值包含:
- $true：会议室具有 Teams 会议室系统。 选择使用会议室音频加入会议时，可以将 Teams 会议室系统添加到Microsoft Teams 会议。
- $false：会议室没有 Teams 会议室系统。 用户可以使用电脑或移动设备音频（而不是会议室音频）加入 Teams 会议。 此值为默认值。
有关Microsoft Teams 会议室的详细信息，请参阅 Microsoft Teams 会议室。
| 属性 | 说明 |
|---|---|
| 类型： | 布尔值 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-DisplayName
DisplayName 参数指定位置的显示名称。 最大长度为 200 个字符。 Set-PlaceV3 只能更新没有关联 SMTP 地址的地点的名称，例如建筑物和楼层。 若要更新具有关联 SMTP 地址的位置（如会议室和工作区）的显示名称，请使用 Exchange Set-Mailbox cmdlet。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
-ParentId
ParentId 参数指定 Microsoft Places 中父位置层次结构中 Place 的 ID。 房间应具有父楼层或分区。 工作区或桌面应具有父分区。 节应具有父级下限。 楼层应具有父级建筑。
注意
如果需要与 Outlook Roomfinder 向后兼容，请确保同时更新“Floor”/“FloorLabel”属性，同时将会议室父级为 floor 实体。 Places Finder 将使用新层次结构，而 Outlook Roomfinder 将使用旧版“Floor”和“FloorLabel”对象。 你还需要确保会议室与会议室列表相关联，如 在 Outlook 中为会议室查找器配置会议室和工作区中所述。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-PostalCode
PostalCode 参数指定建筑物的邮政编码。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-ResourceLinks
ResourceLinks 参数指定应与此建筑关联的外部链接或 Teams 应用 ID，例如餐饮菜单、指向服务的链接或用于访客管理的 Teams 应用。 有关如何在 Places 中设置服务的详细信息，请参阅 Places 中的服务。
值必须作为链接数组提供，如 示例 4 中所示。 每个链接应包含以下属性：名称、值和类型。 例如，链接将编写为 @{name=“TestLink”; value=“;https://contoso.com/" type=”Url“}。
名称
此字符串用于显示链接或应用名称在Places应用中的显示方式。
最大长度为 200 个字符。
值
此值应为 URL 链接或 Teams 应用 ID。 Teams 应用 ID 可以在 Teams 管理中心的“ 管理应用 ”页中的应用的“应用详细信息”页中找到。
最大长度为 1,000 个字符。
类型 必须是受支持的类型之一：
Url - 指示这是一个 URL 链接。
MetaOsApp - 指示此链接是 Teams 应用。
注意
更新时将替换整个集。 若要添加或删除值，请确保包含应保留的先前值。
| 属性 | 说明 |
|---|---|
| 类型： | Link[] |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-SortOrder
SortOrder 参数指定楼层的排序顺序。 例如，一个楼层可能名为“大厅”，排序顺序为 0，以便在有序列表中首先显示此楼层。
| 属性 | 说明 |
|---|---|
| 类型： | System.Int32 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-州
State 参数指定建筑物的州或省。 最大长度为 200 个字符。
建议管理建筑物（而不是会议室/工作区）上的位置数据。 房间 （ 楼层 ->> 建筑物）之间存在层次结构，房间继承其 Building 的位置属性。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-街
Street 参数指定建筑物的物理地址。 最大长度为 200 个字符。
建议管理建筑物（而不是会议室/工作区）上的位置数据。 房间 （ 楼层 ->> 建筑物）之间存在层次结构，会议室继承其 Building 的位置属性。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-标签
Tags 参数指定房间的其他功能 (例如，视图类型或家具类型等详细信息) 。 目前没有最大长度。
可以指定用逗号分隔的多个标签。 如果标签包含空格，请将值括在引号中： "Label 1","Label 2",..."Label N"。
注意
更新时将替换整个集。 若要添加或删除值，请确保包含应保留的先前值。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
疑难解答
我收到权限被拒绝错误。
Set-PlaceV3 需要以下角色之一：TenantPlacesManagement、GlobalAdmin 或 MailRecepients。 由于可以通过不同的方式分配角色，因此支持以下分配角色权限的方法：
- 如果权限是通过 Exchange 管理员 Center (分配的，该中心仅支持永久权限) ，则使用 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 时在会议室和工作区上设置照片。 在此期间，请按照 这些说明 在会议室或工作区上设置照片。
目前无法在建筑物或楼层上设置照片。