Initialize-Places

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

Initialize-Places 分析租户中现有的会议室和工作区,并推断出建筑物、楼层和部分名称。 它允许您在 Places Directory 中创建建筑物、楼层、剖面、房间和工作区的层次结构之前查看和编辑推断的信息。

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

重要

使用最新版本的 Microsoft Places PowerShell 模块。 如果未安装模块,或者 Initialize-Places 未显示此页上记录的选项,请运行:
Install-Module -Name MicrosoftPlaces -Force

然后,在连接到 Microsoft Places 之前,关闭并重新打开 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 中的楼层或分区为父级。

例如:

  • 不与任何会议室列表关联的 Places 不包含在 CSV 中。 这些会议室在“会议室查找器”中不可见,并且默认情况下会被排除在外,以确保它们不会显示在 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 目录的 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) 之前,应查看 & 使用正确的值更新此列
CurrentBuildingLabel 房间或工作区元数据上设置 的建筑物 的当前字符串值
CurrentFloorNumber 在会议室或工作区的元数据上设置 的楼层 的当前整数值
CurrentFloorLabel 在会议室或工作区的元数据上设置的 floorLabel 的当前字符串值
PrimarySmtpAddress 会议室或工作区的 SMTP 地址
名称 会议室/工作区的显示名称
RoomList 会议室/工作区的关联会议室列表
ResourceType 定义资源是会议室还是空间 (工作区)
StreetAddress 会议室/工作区的街道地址
市/县 会议室/工作区所在城市
StateOrProvince 会议室/工作区的省/自治区
CountryOrRegion 会议室/工作区所在的国家/地区
Confidence 推断的建筑物名称和推断的楼层名称的置信度

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

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

列名称 说明
InferredBuildingName (必需) 创建建筑物时使用此名称
InferredFloorName (必需) 创建楼层时使用此名称。
InferredSectionName 在楼层) 上创建剖面 (区域或邻域时使用此名称。 此名称对于工作区是必需的,但对于会议室则是可选的。
PrimarySmtpAddress (必需) 会议室或工作区的 SMTP 地址