Set-PlaceV3
Используйте командлет Set-PlaceV3 для обновления метаданных о комнатах, рабочих областях, этажах или зданиях в каталоге Places.
Примечание.
- Обновления в конференц-залы & рабочих областей может занять до 24 часов. Если вам нужно подключить несколько комнат и рабочих областей, рекомендуется использовать
Initialize-Places, чтобы заставить изменения немедленно отразиться. - В апреле 2024 года Set-UserPhoto был нерекомендуем . Мы работаем над добавлением параметра в этот командлет, чтобы задать фотографию в комнатах и рабочих областях при использовании Set-PlaceV3. Тем временем следуйте этим инструкциям , чтобы установить фотографию в комнате или рабочей области.
Синтаксис
Здание
Set-PlaceV3
[-Identity]
[-DisplayName]
[-Label]
[-IsWheelChairAccessible]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-ResourceLinks]
[-Tags]
Floor
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-SortOrder]
[-Tags]
Раздел
Раздел — это группа пространств в пределах этажа, например района. Столы и рабочие области должны быть родительскими для раздела. Комнаты также могут быть при необходимости родительскими в секцию или они могут быть непосредственно воспитаны на этаже.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Tags]
Стол
Столы — это новый тип сущности в Places, который представляет отдельные столы. Эти объекты могут быть как резервируемыми, так и не резервируемыми (по умолчанию).
Чтобы сделать стол резервируемым, необходимо создать почтовый ящик desk и связать его с объектом desk, передав почтовый ящик Alias параметру MailboxSet-PlaceV3. Обратите внимание, что в отличие от типов комнат и рабочих областей столы не подготавливаются неявно путем создания почтового ящика только. Кроме того, метаданные (например Capacity , поля или DisplayName ) не синхронизируются с метаданными почтового ящика. Почтовый ящик в первую очередь требуется только для подсистемы резервирования, и метаданные будут считываться из каталога Places.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
Комната или рабочая область
Set-PlaceV3 поддерживает устаревшие параметры расположения, уже доступные в командлете Exchange Set-Place. Однако после того, как комната связана с этажом или зданием с помощью -ParentId параметра, сведения о расположении (Street, Cityи т. д.) следует управлять в здании, а не в помещении или рабочей области.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Capacity]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-Building]
[-Floor]
[-FloorLabel]
[-Tags]
Описание
Places зависит от полностью настроенной иерархии между комнатами и рабочими областями, этажами и зданиями. После создания зданий и этажей их можно связать с помощью parentId. Комната должна иметь родительский этаж или секцию. Рабочая область или стол должны иметь родительский раздел. Раздел должен иметь родительский этаж. Этаж должен иметь родительское здание.
Для его запуска необходимо получить соответствующие разрешения. У вас должна быть роль Администратор Exchange или роль Places TenantPlacesManagement.
Предостережение
Вы можете найти дополнительные параметры в командлете PowerShell, но в настоящее время они не поддерживаются. Не рекомендуется использовать параметры, которые не описаны на этой странице.
Примеры
Пример 1
В этом примере настраивается иерархия каталогов для помещения, этажа и здания.
В этом примере placeId пола имеет значение f12172b6-195d-4e6e-8f4f-eb72e41de99a, а placeId здания — daa2f89b-75c4-4eb7-adcc-ff2492333338d.
Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d
Пример 2
В этом примере обновляется адрес здания.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052
Пример 3
В этом примере обновляются геокоординаты здания.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"
Пример 4
В этом примере ссылки на ресурсы для здания обновляются ссылками на ресурсы. Весь набор заменяется при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}
Пример 5
В этом примере создается почтовый ящик стола и назначается существующей сущности desk. Обратите внимание, что необходимо установить ExchangeOnlineManagement модуль и запустить Connect-ExchangeOnline командлет перед выполнением следующего:
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
Параметры
-Identity
Параметр identity указывает место, которое требуется обновить. Можно использовать любое значение, однозначно определяющее место.
Например, для мест на основе почтового ящика (конференц-залов и рабочих областей):
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Например, для мест, которые не основаны на почтовом ящике (здания, этажи, секции и столы):
- Имя
- GUID
| Атрибут | Описание |
|---|---|
| Тип: | RecipientIdParameter |
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Верно |
| Примите подстановочные знаки: | Неверно |
-AudioDeviceName, -DisplayDeviceName и VideoDeviceName
Эти параметры указывают имя звуковых, видео- и видеоустройств в комнате. Если значение содержит пробелы, его необходимо заключить в кавычки (").
По умолчанию значение не задано ($null). Чтобы указать, что в этой комнате нет звукового, отображаемого или видеоустройства, используйте значение $null параметра .
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Здание
Важно!
Параметр building является устаревшим и предоставляется здесь только для обратной совместимости. Сведения о здании будут считываться из сущности Здание, которая находится в родительской цепочке помещения или рабочей области.
Параметр Building указывает имя здания или номер здания, в котором находится помещение. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Способность
Параметр Capacity указывает емкость комнаты. Значение должно быть целым числом.
| Атрибут | Описание |
|---|---|
| Тип: | System.Int32 |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Город
Параметр City указывает город здания. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-CountryOrRegion
Параметр CountryOrRegion указывает страну или регион здания. Допустимым значением является допустимый двухбуквенный код страны ISO 3166-1 (например, AU для Австралии) или соответствующее понятное название страны (которое может отличаться от официального короткого названия АГЕНТСТВА по обслуживанию ISO 3166).
Справочник по двухбуквенный кодов стран можно найти в списке кодов стран.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | CountryInfo |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Label
Параметр Label указывает описательную метку для места. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина — 200 символов.
Для комнат и рабочих областей команда обновляет значение с именем -Label в наборе-месте Exchange.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Верно |
| Примите подстановочные знаки: | Неверно |
-DisplayDeviceName
Параметр DisplayDeviceName указывает имя устройства отображения в комнате. Если значение содержит пробелы, его необходимо заключить в кавычки (").
По умолчанию значение не задано ($null). Чтобы указать, что в этой комнате нет устройства отображения, используйте значение $null для этого параметра.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-FloorLabel
Параметр FloorLabel указывает описательную метку для пола. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Этаж
Параметр Floor задает порядок сортировки пола в определенном здании.
| Атрибут | Описание |
|---|---|
| Тип: | System.Int32 |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-GeoCoordinates
Параметр GeoCoordinates указывает расположение здания в координатах широты, долготы и (при необходимости) высоты. Допустимое значение для этого параметра использует один из следующих форматов:
- Широта и долгота: например, "47,644125;-122,122411"
- Широта, долгота и высота: например, "47,644125;-122,122411; 161.432"
Если разделители периодов не работают, используйте вместо этого запятые.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Существует иерархия между комнатами -> этажами -> зданиями, и комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | GeoCoordinates |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-IsWheelChairAccessible
Параметр IsWheelChairAccessible указывает, доступно ли место для инвалидной коляски. Допустимые значения:
- $true: Место доступно для инвалидной коляски.
- $false: Место не доступно для инвалидной коляски. Это значение используется по умолчанию.
| Атрибут | Описание |
|---|---|
| Тип: | Логический |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-MTREnabled
Примечание.
В настоящее время этот параметр является информационным и не обеспечивает никаких дополнительных функциональных возможностей.
Параметр MTREnabled определяет комнату, настроенную с помощью системы комнат Microsoft Teams. Вы можете добавить системы комнат Teams в качестве источников звука в собраниях Teams, в которых задействована комната. Допустимые значения:
- $true: в комнате есть система комнат Teams. Вы можете добавить систему комнат Teams в собрания Microsoft Teams при выборе присоединения к собранию со звуком комнаты.
- $false: в комнате нет системы комнат Teams. Пользователи могут присоединяться к собраниям Teams, используя звук компьютера или мобильного устройства, а не звук комнаты. Это значение используется по умолчанию.
Дополнительные сведения о Комнаты Microsoft Teams см. в разделе Комнаты Microsoft Teams.
| Атрибут | Описание |
|---|---|
| Тип: | Логический |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-DisplayName
Параметр DisplayName указывает отображаемое имя места. Максимальная длина — 200 символов. Set-PlaceV3 может обновлять только имена мест, не имеющих связанного SMTP-адреса, таких как здания и этажи. Чтобы обновить отображаемое имя места с соответствующим SMTP-адресом, например конференц-залов и рабочих областей, используйте командлет Exchange Set-Mailbox.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-ParentId
Параметр ParentId указывает идентификатор объекта Place в иерархии родительского расположения в Microsoft Places. Комната должна иметь родительский этаж или секцию. Рабочая область или стол должны иметь родительский раздел. Раздел должен иметь родительский этаж. Этаж должен иметь родительское здание.
Примечание.
Если вам нужна обратная совместимость с Outlook Roomfinder, обязательно также обновите свойства "Floor"/"FloorLabel" параллельно с родительским воспитанием комнаты в сущность floor. Places Finder будет использовать новую иерархию, а Outlook Roomfinder будет совместно использовать устаревшие объекты Floor и FloorLabel. Кроме того, необходимо убедиться, что комната связана со списком комнат, как описано в разделе Настройка комнат и рабочих областей для средства поиска помещений в Outlook.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Почтовый код
Параметр PostalCode указывает почтовый индекс здания.
| Атрибут | Описание |
|---|---|
| Тип: | 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.
Примечание.
Весь набор будет заменен при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.
| Атрибут | Описание |
|---|---|
| Тип: | Ссылка[] |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-SortOrder
Параметр SortOrder указывает порядок сортировки пола. Например, этаж может быть назван "Лобби" с порядком сортировки 0, чтобы показать этот этаж первым в упорядоченных списках.
| Атрибут | Описание |
|---|---|
| Тип: | System.Int32 |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Государство
Параметр State указывает штат или провинцию здания. Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Существует иерархия между комнатами -> этажами -> зданиями, и комната наследует атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Улица
Параметр Street указывает физический адрес здания. Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Теги
Параметр Tags указывает дополнительные функции комнаты (например, такие сведения, как тип представления или тип мебели). В настоящее время максимальная длина отсутствует.
Можно указать несколько меток, разделенных запятыми. Если метки содержат пробелы, заключите значения в кавычки: "Label 1","Label 2",..."Label N".
Примечание.
Весь набор будет заменен при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
Устранение неполадок
Я получаю ошибку отказано в разрешениях.
Set-PlaceV3 требуется одна из следующих ролей: TenantPlacesManagement, GlobalAdmin или MailRecepients. Поскольку роли могут назначаться различными способами, ниже приведены поддерживаемые способы назначения разрешений ролей.
- Если разрешение назначается через Exchange Администратор Center (который поддерживает только постоянные разрешения), у вас не должно возникнуть проблем с использованием командлетов Places. Ожидается, что вы не увидите ошибку "Отказано в разрешении".
- Если разрешение назначается через Entra непосредственно пользователю (в качестве постоянной или временной роли), у вас не должно возникнуть проблем с использованием командлетов Places. Ожидается, что вы не увидите ошибку "Отказано в разрешении". Однако синхронизация между Entra и Exchange может быть некоторой задержкой.
- Если разрешение назначается через Entra группе в Entra, частью которой является пользователь, это не поддерживается Exchange и группа ролей не будет соблюдаться. Командлеты Exchange и командлеты Places завершатся сбоем с отказом в разрешении. Это ожидаемое поведение описано здесь.
Я назначил параметр ParentId ресурсу, но пока не вижу его в Places Finder.
Корреляция между ресурсом и его родительским этажом может занять до 24 часов в Places взаимодействиях. Мы работаем над устранением этой задержки.
Разделы справки установить фотографию на ресурсе?
В апреле 2024 года Set-UserPhoto был нерекомендуем . Мы работаем над добавлением параметра в этот командлет, чтобы задать фотографию в комнатах и рабочих областях при использовании Set-PlaceV3. В то же время следуйте этим инструкциям , чтобы установить фотографию в комнате или рабочей области.
В настоящее время невозможно установить фотографии на здании или на этаже.