tipo de recurso teamworkDevice

Artigo
04/03/2024

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa detalhes sobre um dispositivo habilitado para Microsoft Teams provisionado para o locatário.

Os dispositivos habilitados para Microsoft Teams são dispositivos de colaboração certificados pelo Teams. Eles incluem Salas do Microsoft Teams (no Windows e Android), Telefones do Microsoft Teams, painéis, Surface Hubs e dispositivos SIP. Essas categorias são as mesmas disponíveis no centro de administração do Teams na seção Dispositivos do Teams.

Para obter mais informações, consulte Gerenciar seus dispositivos no Microsoft Teams.

Observação: isso não inclui celulares, laptops, computadores, guias e assim por diante.

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
Listar teamworkDevices	Coleção teamworkDevice	Obtenha uma lista de todos os dispositivos habilitados para Microsoft Teams provisionados para um locatário.
Obter teamworkDevice	teamworkDevice	Obtenha as propriedades de um dispositivo habilitado para Microsoft Teams.
Reiniciar	teamworkDeviceOperation	Reinicie o dispositivo habilitado para Microsoft Teams especificado.
runDiagnostics	teamworkDeviceOperation	Execute e gere logs de diagnóstico para o dispositivo habilitado para Microsoft Teams especificado.
updateSoftware	teamworkDeviceOperation	Atualize o software para um dispositivo habilitado para Microsoft Teams.
Listar operações	coleção teamworkDeviceOperation	Obtenha uma lista de operações que estão em execução em um dispositivo habilitado para o Teams.

Propriedades

Propriedade	Tipo	Descrição
activityState	teamworkDeviceActivityState	O estado de atividade do dispositivo. Os valores possíveis são: `unknown`, `busy`, `idle`, `unavailable`, `unknownFutureValue`.
companyAssetTag	Cadeia de caracteres	A marca de ativos da empresa atribuída pelo administrador no dispositivo.
createdBy	identitySet	Identidade do usuário que registrou o dispositivo no locatário.
createdDateTime	DateTimeOffset	A data e a hora utc em que o dispositivo foi registrado no locatário.
Currentuser	teamworkUserIdentity	O usuário conectado no dispositivo.
deviceType	teamworkDeviceType	O tipo de dispositivo. Os valores possíveis são: `unknown`, , `ipPhone`, `teamsRoom`, `surfaceHub`, `collaborationBar`, `teamsDisplay`, `touchConsole`, `lowCostPhone`, `teamsPanel`, , `sip`, `sipAnalog`, . `unknownFutureValue`
hardwareDetail	teamworkHardwareDetail	Uma coleção de propriedades relacionadas ao hardware. Por exemplo, oemSerialNumber e modelo.
healthStatus	teamworkDeviceHealthStatus	O status de integridade do dispositivo. Os valores possíveis são: `unknown`, `offline`, `critical`, `nonUrgent`, `healthy`, `unknownFutureValue`.
id	Cadeia de caracteres	Identificador de dispositivo. Herdado da entidade.
lastModifiedBy	identitySet	Identidade do usuário que modificou pela última vez os detalhes do dispositivo.
lastModifiedDateTime	DateTimeOffset	A data e a hora utc em que o detalhe do dispositivo foi modificado pela última vez.
notes	String	As anotações adicionadas pelo administrador ao dispositivo.

valores teamworkDeviceType

Membro	Valor	Descrição
desconhecido	0	Dispositivo desconhecido.
ipPhone	1	Os dispositivos de telefone IP são os telefones de mesa para os usuários fazerem e receberem chamadas de áudio ou ingressarem em reuniões.
teamsRoom	2	Salas do Microsoft Teams são dispositivos baseados em IoT do Windows projetados para estender a experiência de reunião para a sala de conferência.
surfaceHub	3	Os dispositivos do Surface Hub são dispositivos montados na parede ou montados em roller-stand com quadro interativo.
collaborationBar	4	As barras de colaboração são Salas do Microsoft Teams no Android usadas para pequenos espaços de reunião.
teamsDisplay	5	Os dispositivos de exibição do Teams são a evolução dos telefones do Teams. Esses dispositivos são uma categoria de dispositivos dedicados do Teams dedicados que apresentam uma tela sensível ao toque ambiente e uma experiência de mãos livres alimentada pela Cortana.
touchConsole	6	Os dispositivos touch console são os periféricos opcionais para o Salas do Teams no Android para executar todas as operações do dispositivo.
lowCostPhone	7	Dispositivos telefônicos de baixo custo são telefones econômicos do Microsoft Teams.
teamsPanel	8	Os painéis do Microsoft Teams são os dispositivos touchscreen compactos que exibem detalhes da reunião agendados por meio do Teams.
sip	9	Dispositivos SIP (Protocolo de Iniciação de Sessão) que dão suporte a chamadas do Teams com o Gateway SIP da Microsoft.
sipAnalog	10	Pontos de extremidade analógicos herdados, como telefones de elevador, telefones de estacionamento ou dispositivos de chão de fábrica, que são registrados no Microsoft Teams por meio do Gateway SIP.
unknownFutureValue	11	Valor sentinela de enumeração evoluível. Não usar.

valores teamworkDeviceHealthStatus

Membro	Valor	Descrição
desconhecido	0	Status de integridade desconhecidos.
Offline	1	O dispositivo está offline e não pode ser usado.
Crítico	2	O estado requer atenção e ação urgentes, pois pode ter um impacto significativo no desempenho do dispositivo ou torná-lo inutilizável para chamadas ou reuniões.
nonUrgent	3	O estado requer atenção devido a problemas ou notificações que podem ter um impacto mínimo no desempenho de um dispositivo online.
Saudável	4	O dispositivo está online e em boas condições.
unknownFutureValue	5	Valor sentinela de enumeração evoluível. Não usar.

Relações

Relação	Tipo	Descrição
atividade	teamworkDeviceActivity	As propriedades de atividade que mudam com base no uso do dispositivo.
configuração	teamworkDeviceConfiguration	As propriedades de configuração do dispositivo.
Saúde	teamworkDeviceHealth	As propriedades de integridade do dispositivo.
operations	coleção teamworkDeviceOperation	As operações assíncronas no dispositivo.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@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"
}

Compartilhar via