Поделиться через

Initialize-Places

  • Статья

Командлет Initialize-Places — это упрощенный интерфейс быстрого создания, который можно использовать вместо New-Placeкомандлетов и .Set-PlaceV3

Initialize-Places анализирует существующие комнаты и рабочие области в клиенте, а также выводит имена зданий, этажей и разделов. Она позволяет проверять, редактировать эти сведения, а затем создавать полную иерархию комнат и рабочих областей этажей зданий >> в клиенте. Эту иерархию иногда называют каталогом Places.

На этой странице содержатся сведения о синтаксисе командлета и параметрах. Пошаговые инструкции по использованию этого командлета приведены в разделе Настройка зданий и этажей.

Важно!

Важные обновления были внесены в модуль командлетов MicrosoftPlaces 14 ноября 2024 г. Если вы присоединились к программе предварительной версии до этой даты, получите последнюю версию модуля, запустив 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, но в настоящее время они не поддерживаются. Не рекомендуется использовать параметры, которые не описаны на этой странице.

Вариант 1

Этот параметр анализирует комнаты и рабочие области, настроенные в клиенте, и создает CSV-файл с именемResourceAccountsMapped.csv. Этот CSV-файл содержит другие данные, такие как имена зданий, этажей и разделов, которые выводятся из данных комнат, рабочих мест и RoomList.

CSV-файл содержит только комнаты и рабочие области, найденные в Exchange Online, которые связаны с RoomList и еще не привязаны к полу или разделу в каталоге Places.

Например:

  • Places, не связанные с roomList, не включаются в CSV-файл. Эти комнаты не отображаются в поиске комнат и по умолчанию исключаются, чтобы они не отображались в Places Finder, если позже вы не добавите их вручную.

  • Places, связанные с двумя или более RoomList, включаются. Однако выведенное имя здания остается пустым. Необходимо написать правильное имя здания.

  • Places, уже зарегистрированные на этаже, или раздел не включены в CSV-файл. Скрипт можно выполнять итеративно, когда в Exchange Online добавляются новые комнаты и рабочие области, а выходной CSV-файл должен включать только новые комнаты и рабочие области.

Инструкции по экспорту других помещений и рабочих областей см. в разделе Настройка зданий и этажей, настройка вручную.

Вариант 2

После проверки сведений о помещении и рабочей области, созданных вариантом 1, удалите ненужные столбцы, как указано в разделе Настройка зданий и этажей , и сохраните их в виде нового CSV-файла. Теперь вы можете записать эти сведения обратно в каталог Places с помощью варианта 2.

Любое новое здание, этаж или раздел, найденные в CSV-файле, добавляются в каталог Places, а новые комнаты и рабочие места размещаются на этажах или секциях.

Вы можете разбить работу по зданию, городу или любым другим критериям. Такой подход позволяет итеративно отправлять небольшие CSV-файлы, содержащие подмножество комнат и рабочих мест, которые нужно добавить в каталог Places. При каждой отправке нового CSV-файла в иерархию добавляются здания, этажи и разделы, которые еще не находятся в каталоге Places.

После отправки CSV-файла создается файл с именем fileToImport-ImportResults.csv и сохраняется в той же папке. Этот файл содержит сведения о том, возникли ли какие-либо проблемы во время отправки. На этом этапе становится доступной полная иерархия пространственных данных для использования Microsoft Places в клиенте.

При отправке CSV-файла имена зданий становятся видимыми в интерфейсе Microsoft 365. На практике это означает, что пользователи могут видеть и выбирать эти здания в

  • Рабочие планы (рабочие часы Outlook и расположение)

  • Присутствие на рабочем месте

  • другие возможности, описанные в Microsoft Places обзоре.

Важно!

Убедитесь, что каждое здание, этаж и разделы написаны точно так же в CSV-файле и во всех CSV-файлах, если вы отправляете их итеративно. Различия приводят к созданию дополнительных зданий, этажей или секций.

Вариант 3

Этот расширенный параметр позволяет просмотреть сценарий PowerShell, который настраивает каталог Places перед его выполнением. При использовании этого параметра сценарий PowerShell загружается на компьютер, но не выполняется. Вариант 3 может быть полезен, если вам нужно разделить административные задачи между несколькими людьми.

Сценарий PowerShell называется PlacesOnboardingScript.ps1 и сохраняется в той же папке, что и отправленный CSV-файл. Чтобы настроить каталог Places, необходимо вручную выполнить сценарий PowerShell.

Примечание.

В описании командлета неправильно используется термин "импорт" для варианта 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-адрес комнаты или рабочей области