New-Place
使用 New-Place cmdlet 在 Places 目录中创建建筑物、楼层、分区或办公桌。
注意
若要创建会议室或工作区，需要继续使用此处所述的 New-Mailbox cmdlet 。
语法
生成
New-Place
[-DisplayName]
[-Type]
[-Label]
[-PostalCode]
[-CountryOrRegion]
[-State]
[-City]
[-Street]
[-GeoCoordinates]
[-ResourceLinks]
[-Tags]
Floor
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-SortOrder]
[-Tags]
节
节是楼层内空间的分组，例如邻里。 需要将办公桌和工作区设置为分区的父级。 房间还可以选择性地父化为分区，也可以直接父级到楼层。
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
书桌
办公桌是 Places 中的新实体类型，表示单个办公桌。 这些对象可以是可预订的，也可以是不可预订的， (默认) 。
若要使桌面可预订，需要创建一个 Desk 邮箱，并将其与桌面对象相关联，方法是将邮箱 Alias 传递给 Mailbox 的 Set-PlaceV3参数。 请注意，与会议室/工作区类型不同，不会通过单独创建邮箱来隐式预配办公桌。 此外，元数据 (（如 Capacity 或 DisplayName 字段) ）不会与邮箱元数据保持同步。 仅预留引擎需要邮箱，并且从 Places 目录中读取元数据。
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-GeoCoordinates]
[-Mailbox]
说明
Places取决于会议室/工作区、楼层和建筑物之间的完全设置层次结构。 创建建筑物和楼层后，可以使用 parentId 链接它们。 房间应具有父楼层或分区。 工作区或桌面应具有父分区。 节应具有父级下限。 楼层应具有父级建筑。
您必须先获得权限，然后才能运行此 cmdlet。 必须具有 Exchange 管理员 角色或 Places TenantPlacesManagement 角色。
警告
可以在 PowerShell cmdlet 中找到其他参数，但目前不支持这些参数。 建议不要使用此页上未记录的任何参数。
示例
示例 1
本示例在该建筑物内创建新建筑物和楼层。
New-Place -Type Building -Name 'Building 3'
成功创建建筑物 3 后，读取其 PlaceId，以在楼层上设置 ParentId 时使用。
New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
示例 2
此示例创建一个包含地址信息的新建筑物。
New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052
示例 3
此示例创建一个包含资源链接的新建筑物。
New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'
示例 4
本示例创建一个父级为楼层的分区，然后创建一个桌面邮箱并将其分配给现有桌面实体。 请注意，在运行此示例脚本之前，已安装 ExchangeOnlineManagement 并运行 Connect-ExchangeOnline 该 cmdlet 的模块。
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias
参数
-城市
City 参数指定建筑物的城市。 如果值中有空格，请使用双引号 (") 将此值括起来。 最大长度为 200 个字符。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-CountryOrRegion
CountryOrRegion 参数指定建筑物的国家或地区。 有效值是有效的 ISO 3166-1 双字母国家/地区代码 (例如，澳大利亚的 AU) 或国家/地区 (的相应友好名称，这可能不同于官方的 ISO 3166 维护机构短名称) 。
国家/地区代码列表中提供了双字母国家/ 地区代码的参考。
Places浏览页面使用地址信息来显示附近的建筑物。
| 属性 | 说明 |
|---|---|
| 类型： | CountryInfo |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-Label
Label 参数指定位置的描述性标签。 如果值中有空格，请使用双引号 (") 将此值括起来。 最大长度为 200 个字符。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | True |
| 接受通配符： | False |
-GeoCoordinates
GeoCoordinates 参数指定建筑物的纬度、经度和 (位置（可选) 海拔坐标）。 此参数的有效值使用以下格式之一：
- 纬度和经度：例如，“47.644125;-122.122411”
- 纬度、经度和高度：例如“47.644125;-122.122411;161.432"
注意
如果句点分隔符不起作用，请改用逗号。
| 属性 | 说明 |
|---|---|
| 类型： | GeoCoordinates |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-DisplayName
DisplayName 参数指定位置的显示名称。 最大长度为 200 个字符。
建筑物的显示名称可见：
- 在 Outlook 中，当用户设置其工作时间和位置时，他们能够选择建筑物。
- 在 Places“浏览”页面，其中显示同一栋建筑、附近建筑物中的其他人等。
- 在 Places Finder 中，作为搜索会议室或工作区时的筛选器。
搜索会议室或工作区时，楼层的显示名称在 Places Finder 中显示为筛选器。
| 属性 | 说明 |
|---|---|
| 类型： | 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 参数指定建筑物的邮政编码。 最大长度为 200 个字符。
| 属性 | 说明 |
|---|---|
| 类型： | 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 管理中心的“ 管理应用 ”页中的应用的“应用详细信息”页中找到。
- 最大长度为 1000 个字符。
-
类型 必须是受支持的类型之一：
- Url - 指示这是一个 URL 链接。
- MetaOsApp - 指示此链接是 Teams 应用。
注意
将替换整个集。 若要添加或删除值，请确保包含应保留的先前值。
| 属性 | 说明 |
|---|---|
| 类型： | ResourceLink[] |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-SortOrder
SortOrder 参数指定楼层的排序顺序。 例如，一个楼层可能名为“大厅”，排序顺序为 0，以便在有序列表中首先显示此楼层。
| 属性 | 说明 |
|---|---|
| 类型： | System.Int32 |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-州
State 参数指定建筑物的州或省。 最大长度为 200 个字符。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-街
Street 参数指定建筑物的物理地址。 最大长度为 200 个字符。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-标签
Tags 参数指定房间的其他功能 (例如，视图类型或家具类型等详细信息) 。 目前没有最大长度。
可以指定用逗号分隔的多个标签。 如果标签包含空格，请将值括在引号中： "Label 1","Label 2",..."Label N"。
注意
更新时将替换整个集。 若要添加或删除值，请确保包含应保留的先前值。
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | False |
| 接受管道输入： | False |
| 接受通配符： | False |
-类型
Type 参数指定正在创建的位置的类型。 有效值包含:
- 生成
- Floor
- 节
- 书桌
| 属性 | 说明 |
|---|---|
| 类型： | String |
| 位置： | 叫 |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | True |
| 接受通配符： | False |