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

New-Place

  • Статья

Используйте командлет New-Place для создания зданий, этажей, секций или столов в каталоге Places.

Примечание.

Для создания комнат или рабочих областей необходимо продолжать использовать командлет New-Mailbox, описанный здесь.

Синтаксис

Здание

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 и связать его с объектом desk, передав почтовый ящик Alias параметру MailboxSet-PlaceV3. Обратите внимание, что в отличие от типов комнат и рабочих областей столы не подготавливаются неявно, создавая только почтовый ящик. Кроме того, метаданные (например Capacity , поля или DisplayName ) не синхронизируются с метаданными почтового ящика. Почтовый ящик в первую очередь требуется только для подсистемы резервирования, а метаданные считываются из каталога Places.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]

Описание

Places зависит от полностью настроенной иерархии между комнатами и рабочими областями, этажами и зданиями. После создания зданий и этажей их можно связать с помощью parentId. Комната должна иметь родительский этаж или секцию. Рабочая область или стол должны иметь родительский раздел. Раздел должен иметь родительский этаж. Этаж должен иметь родительское здание.

Для его запуска необходимо получить соответствующие разрешения. У вас должна быть роль Администратор Exchange или роль Places TenantPlacesManagement.

Предостережение

Вы можете найти дополнительные параметры в командлете PowerShell, но в настоящее время они не поддерживаются. Не рекомендуется использовать параметры, которые не описаны на этой странице.

Примеры

Пример 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

В этом примере создается раздел с родительским значением, а затем создается почтовый ящик стола и назначается существующей сущности desk. Обратите внимание, что у вас установлен ExchangeOnlineManagement модуль и выполните Connect-ExchangeOnline командлет перед выполнением этого примера скрипта.

$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
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-CountryOrRegion

Параметр CountryOrRegion указывает страну или регион здания. Допустимым значением является допустимый двухбуквенный код страны ISO 3166-1 (например, AU для Австралии) или соответствующее понятное название страны (которое может отличаться от официального короткого названия АГЕНТСТВА по обслуживанию ISO 3166).

Справочник по двухбуквенный кодов стран можно найти в списке кодов стран.

Сведения об адресе используются на странице обзора Places для отображения близлежащих зданий.

Атрибут Описание
Тип: CountryInfo
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Label

Параметр Label указывает описательную метку для места. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина — 200 символов.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Верно
Примите подстановочные знаки: Неверно

-GeoCoordinates

Параметр GeoCoordinates указывает расположение здания в координатах широты, долготы и (при необходимости) высоты. Допустимое значение для этого параметра использует один из следующих форматов:

  • Широта и долгота: например, "47,644125;-122,122411"
  • Широта, долгота и высота: например, "47,644125;-122,122411; 161.432"

Примечание.

Если разделители периодов не работают, используйте вместо этого запятые.

Атрибут Описание
Тип: GeoCoordinates
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-DisplayName

Параметр DisplayName указывает отображаемое имя места. Максимальная длина — 200 символов.

Отображается отображаемое имя здания:

  • В Outlook, когда пользователи настраивают свое рабочее время и расположение, они могут выбрать здание.
  • На странице Places Обзор, на которой показано, кто еще находится в том же здании, близлежащих зданиях и многое другое.
  • В Places Finder в качестве фильтра при поиске конференц-зала или рабочей области.

Отображаемое имя этажа отображается в Places Finder в качестве фильтра при поиске конференц-зала или рабочей области.

Атрибут Описание
Тип: String
Значение по умолчанию: Нет
Обязательно: Верно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-ParentId

Параметр ParentId указывает идентификатор объекта Place в иерархии родительского расположения в Microsoft Places.

  • Комната должна иметь родительский этаж или секцию.
  • Рабочая область или стол должны иметь родительский раздел.
  • Раздел должен иметь родительский этаж.
  • Этаж должен иметь родительское здание.

Примечание.

Если вам нужна обратная совместимость с Outlook Roomfinder, также обновите свойства "Floor"/"FloorLabel" параллельно с родительским воспитанием комнаты в сущность floor. Places Finder использует новую иерархию, а Outlook Roomfinder продолжает использовать устаревшие объекты Floor и FloorLabel. Кроме того, необходимо убедиться, что комната связана со списком комнат, как описано в разделе Настройка комнат и рабочих областей для средства поиска помещений в Outlook.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Почтовый код

Параметр PostalCode указывает почтовый индекс здания. Максимальная длина — 200 символов.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-ResourceLinks

Параметр ResourceLinks указывает внешние ссылки или идентификаторы приложений Teams , которые должны быть связаны с этим зданием, например меню столовой, ссылку на службы или приложение Teams для управления посетителями. Дополнительные сведения о настройке служб в Places см. в разделе Службы в Places.

Значение должно быть указано в виде массива ссылок, как показано в примере 4. Каждая ссылка должна содержать следующие свойства: Имя, Значение и Тип.  Например, ссылка будет написана как @{name="TestLink"; value="https://contoso.com/"; type="Url"}.

  • Название
    • Эта строка используется для отображения ссылки или имени приложения в приложении Places.
    • Максимальная длина — 200 символов.
  • Значение
    • Это значение должно быть url-ссылкой или идентификатором приложения Teams. Идентификаторы приложений Teams можно найти на странице Сведения о приложении на странице Управление приложениями в Центре администрирования Teams.
    • Максимальная длина — 1000 символов.
  • Тип должен быть одним из поддерживаемых типов:
    • Url — указывает, что это url-ссылка.
    • MetaOsApp — указывает, что эта ссылка является приложением Teams.

Примечание.

Весь набор заменяется. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.

Атрибут Описание
Тип: ResourceLink[]
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-SortOrder

Параметр SortOrder указывает порядок сортировки пола. Например, этаж может быть назван "Лобби" с порядком сортировки 0, чтобы показать этот этаж первым в упорядоченных списках.

Атрибут Описание
Тип: System.Int32
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Государство

Параметр State указывает штат или провинцию здания. Максимальная длина — 200 символов.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Улица

Параметр Street указывает физический адрес здания. Максимальная длина — 200 символов.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Теги

Параметр Tags указывает другие функции комнаты (например, такие сведения, как тип представления или тип мебели). В настоящее время максимальная длина отсутствует.

Можно указать несколько меток, разделенных запятыми. Если метки содержат пробелы, заключите значения в кавычки: "Label 1","Label 2",..."Label N".

Примечание.

Весь набор заменяется при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.

Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Неверно
Примите входные данные конвейера: Неверно
Примите подстановочные знаки: Неверно

-Тип

Параметр Type указывает тип создаваемого места. Допустимые значения:

  • Здание
  • Floor
  • Раздел
  • Стол
Атрибут Описание
Тип: String
Позиция: Названный
Значение по умолчанию: Нет
Обязательно: Верно
Примите входные данные конвейера: Верно
Примите подстановочные знаки: Неверно