Initialize-Places

项目
11/13/2024

cmdlet Initialize-Places 是一种简化的快速创建体验，可用于代替 New-Place、和 Set-PlaceV3 cmdlet。

Initialize-Places 分析租户中的现有会议室和工作区，并推断建筑物、楼层和分区名称。它允许你验证、编辑此信息，然后生成租户中建筑物 > 楼层 > 会议室和工作区的完整层次结构。此层次结构有时称为 Places Directory。

此页提供有关 cmdlet 语法和选项的详细信息。配置建筑物和楼层中提供了使用此 cmdlet 的分步指南。

重要

MicrosoftPlaces cmdlet 模块于 2024 年 11 月 14 日进行了重要更新。如果在该日期之前加入预览版计划，请运行 Run Install-Module -Name MicrosoftPlaces -Force获取模块的最新版本，然后关闭并重新启动 PowerShell。

语法

运行 Initialize-Places 将显示选项列表：

Initialize-Places
Please choose the desired option before continuing:
 1. Export suggested mapping CSV of rooms to buildings/floors.
 2. Import mapping CSV to automatically create buildings/floors and room mappings.
 3. Export PowerShell script with commands to manually create buildings/floors and room mappings based on an imported CSV.

警告

可以在 PowerShell cmdlet 中找到其他参数，但目前不支持这些参数。建议不要使用此页上未记录的任何参数。

选项 1

此选项分析租户中配置的会议室和工作区，并生成名为 ResourceAccountsMapped.csv的 CSV 文件。此 CSV 文件包含从会议室、工作区和 RoomList 数据推断出的其他数据，例如建筑物、楼层和分区名称。

CSV 文件仅包括Exchange Online中找到的与 RoomList 关联的会议室和工作区，并且尚未父级到 Places Directory 中的楼层或分区。

例如：

CSV 中不包含与任何 RoomList 关联的Places。这些会议室在会议室查找器中不可见，默认情况下会排除这些会议室，以确保它们不会显示在 Places Finder 中，除非你稍后手动添加它们。
包含与两个或更多 RoomList 关联的Places。但是，推断出的建筑名称留空。需要写入正确的建筑物名称。
Places已父级到楼层，或分区未包含在 CSV 中。当新会议室和工作区添加到 Exchange Online 中时，可以迭代运行脚本，并且输出 CSV 文件应仅包含新会议室和工作区。

有关如何导出其他会议室和工作区的指南，请参阅配置建筑物和楼层，手动设置。

选项 2

验证选项 1 生成的会议室和工作区信息后，应删除配置建筑物和楼层中所述的不必要的列，并将其保存为新的 CSV 文件。现在，可以使用选项 2 将此信息写回到 Places 目录中。

在 CSV 文件中找到的任何新建筑物、楼层或分区将添加到Places目录，并且新会议室和工作区的父级为楼层/分区。

可以通过构建、城市或任何其他条件来细分工作。此方法允许以迭代方式上传较小的 CSV 文件，这些文件包含要添加到Places目录中的一部分会议室和工作区。每次上传新的 CSV 文件时，Places目录中尚不存在的建筑物、楼层和分区都会添加到层次结构中。

上传 CSV 文件后，将生成名为 fileToImport-ImportResults.csv 的文件，并将其保存到同一文件夹中。此文件记录在上传过程中是否遇到任何问题。在此阶段，租户中的Microsoft Places可以使用空间数据的完整层次结构。

上传 CSV 文件会导致建筑物名称在 Microsoft 365 体验中可见。实际上，这意味着用户可以在

Outlook 工作时间和位置) 的工作计划 (
工作区状态
其他体验，如Microsoft Places概述中所述。

重要

请确保每个建筑物、楼层和分区在 CSV 文件中 的拼写方式完全相同 ，如果以迭代方式上传，则跨 CSV 文件进行拼写。差异会导致创建其他建筑物、楼层或分区。

选项 3

通过此高级选项，可以在执行之前查看用于配置 Places Directory 的 PowerShell 脚本。使用此选项时，PowerShell 脚本将下载到计算机，但不会执行。如果需要在多个人员之间分离管理任务，选项 3 可能很有用。

PowerShell 脚本称为 PlacesOnboardingScript.ps1 ，并且与上传的 CSV 文件保存在同一文件夹中。需要手动执行 PowerShell 脚本来配置Places目录。

注意

cmdlet 说明不正确地为选项 3 使用术语“导入”，但此选项不会在 Places 目录中创建任何内容。它仅生成需要手动执行的脚本。

文件格式

导出文件的文件格式 (选项 1)

列名称	说明
InferredBuildingName	Microsoft Places尝试推断 (建议) 它认为此房间/工作区的建筑名称，具体取决于房间/工作区的建筑属性和关联的会议室列表。在导入选项 2 或选项 3) 之前，应查看 (此列 & 使用正确的值进行更新。
InferredFloorName	Microsoft Places尝试根据会议室/工作区的 floorLabel 属性和关联的会议室列表推断 (建议) 它认为是此会议室/工作区的楼层名称。在导入选项 2 或选项 3) 之前，应查看 (此列 & 使用正确的值进行更新。
InferredSectionName	Microsoft Places建议将 InferredFloorName) (下层名称作为工作区的分区名称，并将其保留为会议室的空白。在导入选项 2 或 3 之前，应查看此列，& 使用正确的值进行更新 (选项 2 或 3)
CurrentBuildingLabel	在会议室或工作区的元数据上生成集的当前字符串值
CurrentFloorNumber	会议室或工作区元数据上设置的楼层的当前整数值
CurrentFloorLabel	对会议室或工作区的元数据设置的 floorLabel 的当前字符串值
PrimarySmtpAddress	会议室或工作区的 smtp 地址
名称	会议室/工作区的显示名称
RoomList	会议室/工作区的关联会议室列表
ResourceType	定义资源是会议室还是空间 (工作区)
StreetAddress	会议室/工作区的街道地址
市/县	会议室/工作区的城市
StateOrProvince	会议室/工作区的州/省
CountryOrRegion	会议室/工作区的国家/地区
Confidence	推断的建筑物名称和推断的楼层名称中的置信度级别

导入所需的文件格式 (选项 2 和 3)

导入的文件必须只有以下四列：

列名称	说明
InferredBuildingName	需要 () 创建建筑物时使用此名称
InferredFloorName	需要 () 创建楼层时使用此名称。
InferredSectionName	在地板) (区域或邻里创建节时使用此名称。此名称对于工作区是必需的，但对于会议室是可选的。
PrimarySmtpAddress	需要 () 会议室或工作区的 smtp 地址

通过