тип ресурса teamworkDevice

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет сведения об устройстве с поддержкой Microsoft Teams, подготовленном для клиента.

Устройства с поддержкой Microsoft Teams — это устройства для совместной работы, сертифицированные Teams. К ним относятся Комнаты Microsoft Teams (в Windows и Android), телефоны Microsoft Teams, панели, Surface Hub и устройства SIP. Эти категории совпадают с теми, которые доступны в Центре администрирования Teams в разделе Устройства Teams.

Дополнительные сведения см. в статье Управление устройствами в Microsoft Teams.

Примечание. Сюда не входят мобильные телефоны, ноутбуки, компьютеры, вкладки и т. д.

Наследует от сущности.

Методы

Метод	Тип возвращаемых данных	Описание
Перечисление командных заданий	коллекция teamworkDevice	Получите список всех устройств с поддержкой Microsoft Teams, подготовленных для клиента.
Получение командной работыУстройство	teamworkDevice	Получение свойств устройства с поддержкой Microsoft Teams.
Перезапустить	teamworkDeviceOperation	Перезапустите указанное устройство с поддержкой Microsoft Teams.
runDiagnostics	teamworkDeviceOperation	Запустите и создайте журналы диагностики для указанного устройства с поддержкой Microsoft Teams.
updateSoftware	teamworkDeviceOperation	Обновите программное обеспечение для устройства с поддержкой Microsoft Teams.
Операции со списком	коллекция teamworkDeviceOperation	Получите список операций, выполняемых на устройстве с поддержкой Teams.

Свойства

Свойство	Тип	Описание
activityState	teamworkDeviceActivityState	Состояние действия устройства. Допустимые значения: unknown, busy, idle, unavailable, unknownFutureValue.
companyAssetTag	String	Тег ресурса компании, назначенный администратором на устройстве.
createdBy	identitySet	Удостоверение пользователя, зарегистрировавшего устройство в клиенте.
createdDateTime	DateTimeOffset	Дата и время регистрации устройства в клиенте в формате UTC.
Currentuser	teamworkUserIdentity	Пользователь, выполнившего вход на устройстве.
deviceType	teamworkDeviceType	Тип устройства. Возможные значения: unknown, , ipPhone, teamsRoomsurfaceHub, collaborationBar, , teamsDisplay, touchConsole, lowCostPhone, teamsPanel, sip, sipAnalog, , . unknownFutureValue
hardwareDetail	teamworkHardwareDetail	Коллекция свойств, связанных с оборудованием. Например, oemSerialNumber и model.
healthStatus	teamworkDeviceHealthStatus	Состояние работоспособности устройства. Допустимые значения: unknown, offline, critical, nonUrgent, healthy, unknownFutureValue.
id	String	Идентификатор устройства. Наследуется от сущности.
lastModifiedBy	identitySet	Удостоверение пользователя, который в последний раз изменял сведения об устройстве.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения сведений об устройстве в формате UTC.
notes	String	Заметки, добавленные администратором на устройство.

значения teamworkDeviceType

Элемент	Значение	Описание
unknown	0	Неизвестное устройство.
ipPhone	1	Устройства IP-телефонов — это настольные телефоны для пользователей, которые могут совершать и принимать звуковые звонки или присоединяться к собраниям.
teamsRoom	2	Комнаты Microsoft Teams — это устройства на основе Windows IoT, предназначенные для расширения возможностей собраний в конференц-зале.
surfaceHub	3	Устройства Surface Hub — это настенные или роликовые устройства с интерактивной доской.
collaborationBar	4	Панели совместной работы — это Комнаты Microsoft Teams в Android, используемых для небольших конференц-залов.
teamsDisplay	5	Устройства отображения Teams — это эволюция телефонов Teams. Эти устройства относятся к категории "все в одном" выделенных устройств Teams, которые имеют внешний сенсорный экран и интерфейс без рук на основе Кортаны.
touchConsole	6	Устройства сенсорной консоли — это необязательные периферийные устройства для Комнаты Teams android для выполнения всех операций с устройством.
lowCostPhone	7	Недорогие телефонные устройства являются экономичными телефонами Microsoft Teams.
teamsPanel	8	Панели Microsoft Teams — это компактные сенсорные устройства, на которых отображаются сведения о собраниях, запланированных через Teams.
sip	9	Устройства по протоколу SIP, поддерживающие вызовы Teams со шлюзом SIP от Майкрософт.
sipAnalog	10	Устаревшие аналоговые конечные точки, такие как лифтовые телефоны, парковки или заводские устройства, зарегистрированные в Microsoft Teams через шлюз SIP.
unknownFutureValue	11	Изменяемое значение перечисления sentinel. Не используйте.

значения teamworkDeviceHealthStatus

Элемент	Значение	Описание
unknown	0	Неизвестное состояние работоспособности.
Автономных	1	Устройство находится в автономном режиме и не может использоваться.
Критических	2	Состояние требует срочного внимания и действий, так как оно может оказать значительное влияние на производительность устройства или сделать его непригодным для звонков или собраний.
nonUrgent	3	Состояние требует внимания из-за проблем или уведомлений, которые могут минимально повлиять на производительность сетевого устройства.
Здорового	4	Устройство подключено и находится в хорошем состоянии.
unknownFutureValue	5	Изменяемое значение перечисления sentinel. Не используйте.

Связи

Связь	Тип	Описание
действие	teamworkDeviceActivity	Свойства действия, которые изменяются в зависимости от использования устройства.
configuration	teamworkDeviceConfiguration	Свойства конфигурации устройства.
Здоровья	teamworkDeviceHealth	Свойства работоспособности устройства.
operations	коллекция teamworkDeviceOperation	Асинхронные операции на устройстве.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.teamworkDevice",
  "activityState": "String",
  "companyAssetTag": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "currentUser": {
    "@odata.type": "microsoft.graph.teamworkUserIdentity"
  },
  "deviceType": "String",
  "hardwareDetail": {
    "@odata.type": "microsoft.graph.teamworkHardwareDetail"
  },
  "healthStatus": "String",
  "id": "String (identifier)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "notes": "String"
}