Set-PlaceV3
Используйте командлет Set-PlaceV3 для обновления метаданных о комнатах, рабочих областях, этажах или зданиях в каталоге "Места".
Примечание.
Обновление конференц-залов & рабочих областей может занять до 24 часов. Мы работаем над устранением этой задержки.
В апреле 2024 года Set-UserPhoto был нерекомендуем . Мы работаем над добавлением параметра в этот командлет, чтобы задать фотографию в комнатах и рабочих областях при использовании Set-PlaceV3. В то же время следуйте этим инструкциям , чтобы установить фотографию в комнате или рабочей области.
Синтаксис
Здание
Set-PlaceV3
[-Identity]
[-City]
[-CountryOrRegion]
[-Description]
[-GeoCoordinates]
[-IsWheelChairAccessible]
[-Name]
[-Phone]
[-PostalCode]
[-ResourceLinks]
[-State]
[-Street]
[-Tags]
Floor
Set-PlaceV3
[-Identity]
[-Description]
[-Name]
[-ParentId]
[-SortOrder]
[-Tags]
Комната или рабочая область
Set-PlaceV3 поддерживает устаревшие параметры расположения, уже доступные в командлете Exchange Set-Place. Однако после того, как помещение связано с этажом или зданием с помощью параметра -ParentId, сведения о расположении (StreetAddress, City и т. д.) следует управлять в здании, а не в комнате или рабочей области.
Set-PlaceV3
[-Identity]
[-AudioDeviceName]
[-Building]
[-Capacity]
[-City]
[-CountryOrRegion]
[-Description]
[-DisplayDeviceName]
[-Floor]
[-FloorLabel]
[-GeoCoordinates]
[-IsWheelChairAccessible]
[-MTREnabled]
[-Name]
[-ParentId]
[-Phone]
[-PostalCode]
[-State]
[-Street]
[-Tags]
[-VideoDeviceName]
Описание
Расположение зависит от полностью настроенной иерархии между комнатами и рабочими областями, этажами и зданиями. После создания зданий и этажей их можно связать с помощью parentId. Родитель комнаты или рабочей области — это пол. Родитель этажа — это здание.
Для его запуска необходимо получить соответствующие разрешения. У вас должна быть роль Exchange MailRecipients или 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"}
Параметры
-Identity
Параметр identity указывает место, которое требуется обновить. Можно использовать любое значение, однозначно определяющее место.
Например, для мест на основе почтового ящика (конференц-залов и рабочих областей):
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Например, для мест, которые не основаны на почтовом ящике (здания и этажи):
- Имя
- GUID
| Атрибут | Описание |
|---|---|
| Тип: | RecipientIdParameter |
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Верно |
| Примите подстановочные знаки: | Неверно |
-AudioDeviceName
Параметр AudioDeviceName указывает имя звукового устройства в комнате. Если значение содержит пробелы, его необходимо заключить в кавычки (").
По умолчанию значение не задано ($null). Чтобы указать, что в этой комнате нет звукового устройства, используйте значение $null для этого параметра.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Здание
Параметр Building указывает имя здания или номер здания, в котором находится помещение. Если значение содержит пробелы, его необходимо заключить в кавычки (").
После установки ParentId для комнаты или рабочей области параметр Building будет доступен только для чтения для этой комнаты или рабочей области. Чтобы изменить имя здания, обновите здание напрямую с помощью Set-PlaceV3.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Способность
Параметр Capacity указывает емкость комнаты. Значение должно быть целым числом.
| Атрибут | Описание |
|---|---|
| Тип: | System.Int32 |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Город
Параметр City указывает город здания. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-CountryOrRegion
Параметр CountryOrRegion указывает страну или регион здания. Допустимым значением является допустимый двухбуквенный код страны ISO 3166-1 (например, AU для Австралии) или соответствующее понятное название страны (которое может отличаться от официального короткого названия АГЕНТСТВА по обслуживанию ISO 3166).
Справочник по двухбуквенный кодов стран можно найти в списке кодов стран.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | CountryInfo |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Description
Параметр Description указывает описательную метку для места. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина — 200 символов.
Для комнат и рабочих областей команда обновляет значение с именем -Label в наборе-месте Exchange.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Верно |
| Примите подстановочные знаки: | Неверно |
-DisplayDeviceName
Параметр DisplayDeviceName указывает имя устройства отображения в комнате. Если значение содержит пробелы, его необходимо заключить в кавычки (").
По умолчанию значение не задано ($null). Чтобы указать, что в этой комнате нет устройства отображения, используйте значение $null для этого параметра.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-FloorLabel
Параметр FloorLabel указывает описательную метку для пола. Если значение содержит пробелы, его необходимо заключить в кавычки (").
После установки параметра ParentId для комнаты или рабочей области параметр FloorLabel будет доступен только для чтения для этой комнаты или рабочей области. Чтобы изменить метку пола, обновите пол непосредственно с помощью Set-PlaceV3.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-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.
| Атрибут | Описание |
|---|---|
| Тип: | Логический |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Name
Параметр Name указывает отображаемое имя места. Максимальная длина — 200 символов. Set-PlaceV3 может обновлять только имена мест, не имеющих связанного SMTP-адреса, таких как здания и этажи. Чтобы обновить отображаемое имя места с соответствующим SMTP-адресом, например конференц-залов и рабочих областей, используйте командлет Exchange Set-Mailbox.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-ParentId
Параметр ParentId указывает идентификатор объекта Place в иерархии родительского расположения в Microsoft Places. В комнате или рабочей области должен быть родительский этаж. Этаж должен иметь родительское здание.
После установки parentID для комнаты или рабочей области некоторые параметры, фактически касающиеся пола (например, FloorLabel) или здания (например, сведения об адресе и расположении), будут доступны только для чтения для этой комнаты или рабочей области с помощью Set-Place версии 3. Те же свойства можно обновить, обновив этаж или здание непосредственно с помощью Set-PlaceV3.
Важно!
Для добавления ParentId рекомендуется использовать только Set-PlaceV3. После установки ParentId не изменяйте ParentId. Командлет Set-PlaceV3 в настоящее время позволяет изменить ParentId, но это приведет к проблемам иерархии каталогов.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Почтовый код
Параметр PostalCode указывает почтовый индекс комнаты.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-ResourceLinks
Параметр ResourceLinks указывает внешние ссылки или идентификаторы приложений Teams , которые должны быть связаны с этим зданием, например меню, ссылка на службы или приложение Teams для управления посетителями. Дополнительные сведения о настройке служб в местах см. в разделе Службы в местах.
Значение должно быть указано в виде массива ссылок, как показано в примере 4. Каждая ссылка должна содержать следующие свойства: Имя, Значение и Тип. Например, ссылка будет написана как @{name="TestLink"; value="https://contoso.com/"; type="Url"}.
Название
Эта строка будет использоваться для отображения ссылки или имени приложения в приложении "Места".
Максимальная длина — 200 символов.
Значение
Это значение должно быть url-ссылкой или идентификатором приложения Teams. Идентификаторы приложений Teams можно найти на странице Сведения о приложении на странице Управление приложениями в Центре администрирования Teams.
Максимальная длина — 1000 символов.
Тип должен быть одним из поддерживаемых типов:
Url — указывает, что это url-ссылка.
MetaOsApp — указывает, что эта ссылка является приложением Teams.
Примечание.
Весь набор будет заменен при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.
| Атрибут | Описание |
|---|---|
| Тип: | Ссылка[] |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-SortOrder
Параметр SortOrder указывает порядок сортировки пола. Например, этаж может быть назван "Лобби" с порядком сортировки 0, чтобы показать этот этаж первым в упорядоченных списках.
Для комнат и рабочих областей при этом обновляется значение с именем -Floor в наборе-месте Exchange.
После установки параметра ParentId для комнаты или рабочей области параметр SortOrder (-Floor) будет доступен только для чтения для этой комнаты или рабочей области с помощью Set-Place версии 3. Порядок сортировки пола можно обновить, обновив пол непосредственно с помощью Set-PlaceV3.
| Атрибут | Описание |
|---|---|
| Тип: | System.Int32 |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Государство
Параметр State указывает состояние или провинцию комнаты. Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Существует иерархия между комнатами -> этажами -> зданиями, и комната наследует атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Улица
Параметр Street указывает физический адрес помещения. Максимальная длина — 200 символов.
Рекомендуется управлять данными о расположении в здании, а не в помещении или рабочей области. Между комнатами — этажами —>> зданиями существует иерархия, а комнаты наследуют атрибуты расположения их здания.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-Теги
Параметр Tags указывает дополнительные функции комнаты (например, такие сведения, как тип представления или тип мебели). В настоящее время максимальная длина отсутствует.
Можно указать несколько меток, разделенных запятыми. Если метки содержат пробелы, заключите значения в кавычки: "Label 1","Label 2",..."Label N".
Примечание.
Весь набор будет заменен при обновлении. Чтобы добавить или удалить значение, обязательно включите предыдущие значения, которые должны быть сохранены.
| Атрибут | Описание |
|---|---|
| Тип: | String |
| Позиция: | Названный |
| Значение по умолчанию: | Нет |
| Обязательно: | Неверно |
| Примите входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по