tipo de recurso de dispositivo
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 um dispositivo registado no diretório . Dispositivos são criados na nuvem usando o Serviço de Registro de Dispositivo ou por meio do Intune. Eles são utilizados por políticas de acesso condicional para a autenticação multifator. Estes dispositivos podem variar desde computadores desktop e laptops até telefones e tablets. Herda de directoryObject.
Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas.
Esse recurso permite:
- Adicionar seus próprios dados às propriedades personalizadas como extensions.
- Usar a consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta.
-
Capacidades de consulta OData , incluindo
$select,$filter,$searche$top. As utilizações específicas são suportadas apenas com capacidades de consulta Avançadas.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção device | Recupere uma lista de dispositivos registrados no diretório. |
| Create | device | Registar um novo dispositivo no diretório. |
| Get | device | Ler propriedades e relações do objeto do dispositivo. |
| Atualizar | device | Atualize as propriedades do objeto do dispositivo. |
| Delete | Nenhum | Elimine o objeto do dispositivo. |
| Obter delta | Coleção device | Obter alterações incrementais para dispositivos. |
| Listar membro de | Coleção directoryObject | Liste os grupos e unidades administrativas dos quais o dispositivo é um membro direto. |
| Listar membro transitivo de | Coleção directoryObject | Liste os grupos e unidades administrativas dos quais o dispositivo é membro. Esta operação é transitiva. |
| Listar proprietários registrados | Coleção directoryObject | Obtenha os usuários que são proprietários registrados do dispositivo da propriedade de navegação registeredOwners. |
| Adicionar proprietários registados | Coleção directoryObject | Adicionar proprietários registados do dispositivo. |
| Remover proprietários registados | Coleção directoryObject | Elimine os proprietários registados do dispositivo. |
| Listar usuários registrados | Coleção directoryObject | Obtenha os usuários registrados do dispositivo da propriedade de navegação registeredUsers. |
| Adicionar utilizadores registados | Coleção directoryObject | Adicione utilizadores registados do dispositivo . |
| Remover utilizadores registados | Coleção directoryObject | Remova os utilizadores registados do dispositivo . |
| Listar direitos de utilização | Coleção usageRight | Obtenha uma coleção de direitos de utilização concedidos ao dispositivo. |
| Verificar grupos de membros | Coleção de cadeias de caracteres | Verifique se há uma associação em uma lista de grupos. A verificação é transitiva. |
| Obter grupos de membros | String collection | Devolver todos os grupos dos quais o dispositivo é membro. A verificação é transitiva. |
| Verificar objetos de membro | String collection | Verifique a associação numa lista de grupos, função de diretório ou objetos de unidade administrativa. |
| Obter objetos de membros | String collection | Devolver todos os grupos, unidades administrativas e funções de diretório dos quais o dispositivo é membro. A verificação é transitiva. |
Propriedades
Importante
O uso específico de $filter e o parâmetro de consulta $search é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual e $count. Para obter mais informações, veja Capacidades avançadas de consulta em objetos de diretório.
| Propriedade | Tipo | Descrição |
|---|---|---|
| accountEnabled | Booliano |
true se a conta estiver habilitada; caso contrário, false. O padrão é true. Suporta $filter (eq, ne, not, in). Apenas os autores de chamadas com, pelo menos, a função Administrador de Dispositivos na Cloud podem definir esta propriedade. |
| alternativeSecurityIds | Coleção alternativeSecurityId | Apenas para uso interno. Não anulável. Suporta $filter (eq, not, ge, le). |
| approximateLastSignInDateTime | DateTimeOffset | O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura.
$filter Suporta (eq, ne, not, ge, lee eq nos null valores) e $orderby. |
| complianceExpirationDateTime | DateTimeOffset | O carimbo de data/hora quando o dispositivo já não é considerado conforme. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. |
| deviceCategory | Cadeia de caracteres | A propriedade definida pelo utilizador definida pelo Intune para adicionar automaticamente dispositivos a grupos e simplificar a gestão de dispositivos. |
| deviceId | Cadeia de caracteres | Identificador Exclusivo definido pelo Serviço de Registo de Dispositivos do Azure no momento do registo. Esta é uma chave alternativa que pode ser utilizada para referenciar o objeto do dispositivo. Também suporta $filter (eq, ne, not, startsWith). |
| deviceMetadata | String | Apenas para uso interno. Definido como null |
| deviceOwnership | Cadeia de caracteres | Propriedade do dispositivo. Esta propriedade é definida por Intune. Os valores possíveis são: unknown, company, personal. |
| deviceVersion | Int32 | Apenas para uso interno. |
| displayName | String | O nome de exibição do dispositivo. O comprimento máximo é de 256 caracteres. Obrigatório. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores), $search, e $orderby. |
| domainName | Cadeia de caracteres | O nome de domínio no local do Microsoft Entra dispositivos associados híbridos. Esta propriedade é definida por Intune. |
| enrollmentProfileName | Cadeia de caracteres | Perfil de inscrição aplicado ao dispositivo. Por exemplo, Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers ou Windows Autopilot profile name. Esta propriedade é definida por Intune. |
| enrollmentType | Cadeia de caracteres | Tipo de registro do dispositivo. Esta propriedade é definida por Intune. Os valores possíveis são: unknown, , userEnrollment, deviceEnrollmentManagerappleBulkWithUser, , appleBulkWithoutUser, windowsAzureADJoinwindowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, , windowsCoManagement, , windowsAzureADJoinUsingDeviceAuth,appleUserEnrollment, appleUserEnrollmentWithServiceAccount. NOTA: Esta propriedade pode devolver outros valores para além dos listados. |
| extensionAttributes | onPremisesExtensionAttributes | Contém atributos de extensão 1 a 15 para o dispositivo. Os atributos de extensão individuais não são selecionáveis. Estas propriedades são mestres na cloud e podem ser definidas durante a criação ou atualização de um objeto de dispositivo no Microsoft Entra ID. Suporte $filter (eq, not, startsWith, e eq no null valores). |
| nomes de anfitrião | String collection | Lista de nomes de anfitrião do dispositivo. |
| id | String | O identificador exclusivo do dispositivo. Herdado de directoryObject. Chave, Não anulável. Somente leitura. Suporta $filter (eq, ne, not, in). |
| isCompliant | Booliano |
truese o dispositivo estiver em conformidade com as políticas de Gerenciamento de Dispositivos Móvel (MDM), caso contrário, false. Somente leitura. Isto só pode ser atualizado por Intune para qualquer tipo de SO do dispositivo ou por uma aplicação MDM aprovada para dispositivos do SO Windows. Suporta $filter (eq, ne, not). |
| isManaged | Booliano |
truese o dispositivo for gerido por uma aplicação mobile Gerenciamento de Dispositivos (MDM), caso contrário, false. Isto só pode ser atualizado por Intune para qualquer tipo de SO do dispositivo ou por uma aplicação MDM aprovada para dispositivos do SO Windows. Suporta $filter (eq, ne, not). |
| isManagementRestricted | Booliano | Indica se o dispositivo é membro de uma unidade administrativa de gestão restrita. O valor padrão é false. Somente leitura. Para gerir um dispositivo que seja membro de uma unidade administrativa de gestão restrita, tem de ser atribuída ao administrador ou à aplicação de chamada uma função Microsoft Entra no âmbito da unidade administrativa de gestão restrita. |
| isRooted | Booliano |
true se o dispositivo tiver root ou jailbreak. Esta propriedade só pode ser atualizada por Intune. |
| Tipo | Cadeia de caracteres | Fator de forma do dispositivo. Apenas devolvido se o utilizador iniciar sessão com uma conta Microsoft como parte do Project Roma. |
| managementType | Cadeia de caracteres | Canal de gerenciamento do dispositivo. Esta propriedade é definida por Intune. Os valores possíveis são: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController. |
| fabricante | Cadeia de caracteres | Fabricante do dispositivo. Somente leitura. |
| mdmAppId | Cadeia de caracteres | Identificador da aplicação utilizado para registar o dispositivo na MDM. Somente leitura. Suporta $filter (eq, ne, not, startsWith). |
| modelo | Cadeia de caracteres | Modelo do dispositivo. Somente leitura. |
| name | Cadeia de caracteres | Nome amigável do dispositivo. Apenas devolvido se o utilizador iniciar sessão com uma conta Microsoft como parte do Project Roma. |
| onPremisesLastSyncDateTime | DateTimeOffset | A última vez em que o objeto foi sincronizado com o diretório no local. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, a meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z Só de leitura. Suporta $filter (eq, ne, not, ge, le, in). |
| onPremisesSecurityIdentifier | String | O identificador de segurança no local (SID) para o utilizador que foi sincronizado do local para a cloud. Somente leitura. Retornado apenas em $select. Suporta $filter (eq). |
| onPremisesSyncEnabled | Booliano |
true se esse objeto está sincronizado de um diretório local; false se esse objeto foi originalmente sincronizado de um diretório local, mas não está mais sincronizado; null se esse objeto nunca foi sido sincronizado de um diretório local (padrão). Somente leitura. Suporte $filter (eq, ne, not, in, e eq no null valores). |
| operatingSystem | String | O tipo de sistema operacional do dispositivo. Obrigatório.
$filter Suporta (eq, ne, not, ge, le, startsWithe eq nos null valores). |
| operatingSystemVersion | String | A versão do sistema operacional do dispositivo. Obrigatório.
$filter Suporta (eq, ne, not, ge, le, startsWithe eq nos null valores). |
| physicalIds | String collection | Apenas para uso interno. Não anulável.
$filter Suporta (eq, not, , gele, startsWith, , /$count eq 0. /$count ne 0 |
| plataforma | Cadeia de caracteres | Plataforma do dispositivo. Apenas devolvido se o utilizador iniciar sessão com uma conta Microsoft como parte do Project Roma. |
| profileType | Cadeia de caracteres | O tipo de perfil do dispositivo. Valores possíveis: RegisteredDevice (predefinição), SecureVM, Printer, Shared, IoT. |
| registrationDateTime | DateTimeOffset | Data e hora de registo do dispositivo. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. |
| status | Cadeia de caracteres | O dispositivo é online ou offline. Apenas devolvido se o utilizador iniciar sessão com uma conta Microsoft como parte do Project Roma. |
| systemLabels | String collection | Lista de etiquetas aplicadas ao dispositivo pelo sistema. Suporta $filter (/$count eq 0, /$count ne 0). |
| trustType | Cadeia de caracteres | Tipo de relação de confiança para o dispositivo associado. Somente leitura. Valores possíveis: Workplace (indica bring your own personal devices), AzureAd (Dispositivos associados apenas à cloud), ServerAd (dispositivos associados a um domínio no local associados a Microsoft Entra ID). Para obter mais informações, veja Introdução à gestão de dispositivos no Microsoft Entra ID. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| comandos | coleção de comandos | Conjunto de comandos enviados para este dispositivo. |
| extensions | Coleção extension | A coleção de extensões abertas definidas para o dispositivo. Somente leitura. Anulável. |
| memberOf | Coleção directoryObject | Grupos e unidades administrativas das quais este dispositivo é membro. Somente leitura. Anulável. Suporta o $expand. |
| registeredOwners | Coleção directoryObject | O usuário que associou o dispositivo na nuvem ou registrou seu dispositivo pessoal. O proprietário registrado é definido no momento do registro. Somente leitura. Anulável. Suporta o $expand. |
| registeredUsers | Coleção directoryObject | Coleção de usuários registrados do dispositivo. Para dispositivos associados em nuvem e dispositivos pessoais registrados, os usuários registrados são definidos para o mesmo valor que proprietários registrados no momento do registro. Somente leitura. Anulável. Suporta o $expand. |
| transitiveMemberOf | Coleção directoryObject | Grupos e unidades administrativas das quais este dispositivo é membro. Esta operação é transitiva. Oferece suporte para $expand. |
| Direitosdeuso | Coleção usageRight | Representa os direitos de utilização concedidos a um dispositivo. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"accountEnabled": "Boolean",
"approximateLastSignInDateTime": "String (timestamp)",
"complianceExpirationDateTime": "String (timestamp)",
"deviceCategory": "String",
"deviceId": "String",
"deviceMetadata": "String",
"deviceOwnership": "String",
"deviceVersion": "Int32",
"displayName": "String",
"domainName": "String",
"enrollmentProfileName": "String",
"enrollmentType": "String",
"extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
"hostnames" : ["String"],
"id": "String (identifier)",
"isCompliant": "Boolean",
"isManaged": "Boolean",
"isRooted": "Boolean",
"kind": "String",
"managementType": "String",
"manufacturer": "String",
"mdmAppId": "String",
"model": "String",
"name": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": "Boolean",
"operatingSystem": "String",
"operatingSystemVersion": "String",
"physicalIds": ["String"],
"platform": "String",
"profileType": "String",
"registrationDateTime": "String (timestamp)",
"status": "String",
"systemLabels": ["String"],
"trustType": "String"
}