Быстрая настройка зданий и этажей

Статья
07/04/2024

Microsoft Places зависит от полностью настроенной иерархии между комнатами и рабочими областями, этажами и зданиями. Сначала необходимо создать здания и этажи, а затем связать их с комнатами и рабочими областями с помощью ParentId.

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

Имя здания
Имя этажа
SMTP существующей конференц-комнаты или рабочей области

Используйте Set-PlaceV3 , чтобы добавить дополнительные метаданные на здания и этажи, отличные от имени.

Что нужно знать перед началом работы

Предполагаемое время завершения: от 5 до 30 минут в зависимости от времени, необходимого для завершения строительства здания и названия этажей.
Для его запуска необходимо получить соответствующие разрешения. У вас должна быть роль Exchange MailRecipients и роль Places TenantPlacesManagement.
Прежде чем использовать любой из командлетов PowerShell Places, необходимо сначала подключиться с помощью Connect-MicrosoftPlaces.

Включение в организацию использования каталога "Места"

В настоящее время перед настройкой каталога мест необходимо согласиться. Этот шаг согласия на включение каталога требуется только во время предварительной версии.

Примечание.

После включения каталога Places для вашей организации вы не сможете отключить каталог. Однако настройка иерархии расположений каталогов не изменяет и не влияет на работу в средстве поиска помещений. Единственное видимое изменение в организации — это планы работы Microsoft Places в Outlook и Teams. Теперь при настройке рабочего расположения пользователи увидят возможность выбора определенного здания. Тем не менее пользователи по-прежнему могут выбрать Office в качестве рабочего места и не обязаны выбирать конкретное расположение здания.

Этот пример позволяет вашей организации использовать каталог Places.

Set-PlacesSettings -Collection Places -EnableBuildings 'Default:true'

Создание зданий, этажей и связывание их с комнатами и рабочими областями

Экспортируйте список комнат или рабочих областей.
- Используйте Get-PlaceV3 для экспорта всех комнат, независимо от того, входят ли они в список комнат.
- Используйте Параметр 1 Initialize-Places, чтобы экспортировать только комнаты или рабочие области, входящие в список помещений. Это действие гарантирует, что в поиске мест отображаются те же комнаты, что и в поиске помещений.
```
Get-Placev3 -Type Room | Export-Csv -NoTypeInformation "C:\temp\rooms.csv"
```
```
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.
```
Подготовьте файл для импорта.
- Добавьте или исправьте имя здания и имя этажа в первых двух столбцах (InferredBuildingName, InferredFloorName). Остальные столбцы с метаданными комнат предоставляются только для справки по мере завершения работы с названиями зданий и этажей.
- Удалите все столбцы, кроме InferredBuildingName, InferredFloorName и PrimarySmtpAddress.
Снова запустите командлет Initialize-Places. Выберите вариант 2, чтобы импортировать CSV-файл.
- Перед импортом убедитесь, что CSV-файл сохранен и закрыт.
- В окне PowerShell будут отображаться сведения о процессе создания, а файл с сводкой результатов экспортируется в ту же папку, что и файл импорта.

Предупреждение

Просмотр обновленных комнат и рабочих областей в Microsoft Places может занять до 24 часов. Мы работаем над устранением этой задержки. Вновь созданные здания и этажи появятся сразу.

Пример

В этом примере показан файл импорта, который приведет к созданию двух зданий. Остин 550 будет иметь три этажа, и NYC Times Square будет иметь один этаж, созданный с именем по умолчанию "Unknown". Конференц-залы связаны с соответствующим этажом или зданием.

InferredBuildingName	InferredFloorName	PrimarySmtpAddress
Остин 550	Мезонин	baker@contoso.com
Остин 550	1	adams@contoso.com
Остин 550	2	rainier@contoso.com
Нью-Йорк Таймс-Сквер		olympus@contoso.com

Вопросы и ответы

Нужно ли одновременно настраивать все мои здания и этажи?

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

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

Мой отдел безопасности хочет знать, какие команды PowerShell выполняются во время импорта

Вы можете использовать вариант 3 (Экспорт скрипта PowerShell) для предварительного просмотра команд, которые будут выполняться. В этом параметре вы предоставляете один и тот же файл импорта из трех столбцов. Вместо настройки зданий, этажей и комнат Initialize-Places экспортирует скрипт PowerShell команд, которые будут выполняться во время импорта. Сценарий PowerShell экспортируется в ту же папку, что и файл импорта.

Примечание.

Файл импорта необходим только для создания скрипта PowerShell. От вашего имени ничего не импортируется.

Экспортируемый скрипт PowerShell можно использовать для выполнения команд самостоятельно, а не использовать вариант 2 в приложении Initialize-Places.

Можно ли выполнить импорт только с именами зданий?

Нет. Цель этого процесса — помочь вам связать комнаты с этажами & зданиями. Для этого требуется наличие всех трех столбцов, хотя имя этажа может быть пустым, что приводит к по умолчанию к имени "Unknown" для пола. Если вы хотите создавать только здания, используйте команду New-Place.

Как обновить данные комнаты, такие как емкость или отображаемое имя?

Это можно сделать с помощью Set-PlaceV3.

Устранение неполадок

Я получаю ошибку проверки подлинности

Необходимо иметь разрешение Exchange MailRecipients и разрешения Places TenantPlacesManagement. Назначенные роли можно проверить в окне Exchange PowerShell. Убедитесь, что это действие выполняется в отдельном окне, отличном от модуля Microsoft Places PowerShell.

Я не вижу одинаковые параметры при выполнении команды Initialize-Places

Убедитесь, что установлена последняя версия модуля Microsoft Places PowerShell. PowerShell может попытаться кэшировать установленный модуль, поэтому убедитесь, что используется параметр -*Force .

Install-Module –Name MicrosoftPlaces –AllowPrerelease -Force

Я получаю ошибку импорта

Убедитесь, что файл импорта закрыт. Если он по-прежнему открыт в Excel или других программах, возможно, вы не сможете импортировать.

Я не вижу все комнаты после импорта

Для появления ассоциаций комнат может потребоваться до 24 часов. Мы работаем над устранением этой задержки.

Настройка вручную

Если вы предпочитаете вручную настраивать здания, этажи и комнаты, можно выполнить отдельные командлеты PowerShell, чтобы создать здания и этажи, а затем связать их с комнатой. Ссылки на New-Place и Set-PlaceV3. Сначала необходимо создать здания, а затем этажи с ParentId, установленными в здании, и, наконец, установить ParentId комнаты или рабочей области на пол.

New-Place -Type Building -Name "Austin 550"
New-Place -Type Floor -Name "1" -ParentId {PlaceId of Austin550}
Set-PlaceV3 -Identity {smtpAddressOfRoom} -ParentId {PlaceId of Floor1}

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