tipo de recurso de dispositivo

  • Artigo

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 registrado 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. Você também pode adicionar seus próprios dados a propriedades personalizadas como extensões.

Métodos

Método Tipo de retorno Descrição
Obter dispositivo device Leia propriedades e relações do objeto do dispositivo.
Listar dispositivos Coleção device Recupere uma lista de dispositivos registrados no diretório.
Atualizar dispositivo device Atualize as propriedades do objeto do dispositivo.
Excluir dispositivo Nenhum Exclua o objeto do dispositivo.
delta Coleção device Obtenha alterações incrementais para dispositivos.
Listar memberOf Coleção directoryObject Liste os grupos e unidades administrativas dos quais o dispositivo é membro direto.
List transitive memberOf Coleção directoryObject Liste os grupos e unidades administrativas dos quais o dispositivo é membro. Essa operação é transitiva.
Listar registeredOwners Coleção directoryObject Obtenha os usuários que são proprietários registrados do dispositivo da propriedade de navegação registeredOwners.
Listar registeredUsers Coleção directoryObject Obtenha os usuários registrados do dispositivo da propriedade de navegação registeredUsers.
List usageRights Coleção usageRight Obtenha uma coleção de direitos de uso concedidos ao dispositivo.
checkMemberGroups Coleção de cadeias de caracteres Verifique se há uma associação em uma lista de grupos. A verificação é transitiva.
getMemberGroups String collection Retorne todos os grupos dos quais o dispositivo é membro. A verificação é transitiva.
checkMemberObjects Coleção de cadeias de caracteres Verifique se há associação em uma lista de grupos, função de diretório ou objetos de unidade administrativa.
getMemberObjects String collection Retorne todos os grupos, unidades administrativas e funções de diretório das quais o dispositivo é membro. A verificação é transitiva.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Extensões de esquema
Adicionar valores de extensões de esquema Criar uma definição para a extensão de esquema e usá-la para adicionar dados digitados personalizados a um recurso.

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, consulte Recursos avançados 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). Somente os chamadores nas funções administrador global e administrador de dispositivo de nuvem podem definir essa 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 e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. $filter Dá suporte (eq, , notne, ge, lee eq em null valores) e $orderby.
complianceExpirationDateTime DateTimeOffset O carimbo de data/hora em que o dispositivo não é mais considerado compatível. O tipo de carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo 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 usuário definida por Intune para adicionar dispositivos automaticamente a grupos e simplificar o gerenciamento de dispositivos.
deviceId Cadeia de caracteres Identificador Exclusivo definido pelo Serviço de Registro de Dispositivo do Azure no momento do registro. Essa é uma chave alternativa que pode ser usada para fazer referência ao objeto do dispositivo. Também dá $filter suporte (eq, , ne, startsWithnot).
deviceMetadata String Apenas para uso interno. Definido como null
deviceOwnership Cadeia de caracteres Propriedade do dispositivo. Essa 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. 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 local de Microsoft Entra dispositivos híbridos ingressados. Essa propriedade é definida por Intune.
enrollmentProfileName Cadeia de caracteres Perfil de registro aplicado ao dispositivo. Por exemplo, Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers ou Windows Autopilot profile name. Essa propriedade é definida por Intune.
enrollmentType Cadeia de caracteres Tipo de registro do dispositivo. Essa propriedade é definida por Intune. Os valores possíveis são: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement.
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. Essas propriedades são mestres na nuvem e podem ser definidas durante a criação ou atualização de um objeto de dispositivo em Microsoft Entra ID.

Suporte $filter (eq, not, startsWith, e eq no null valores).
Hostnames Coleção String Lista de nomes de host para o 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 MDM (mobile Gerenciamento de Dispositivos) ; caso contrário, false. Somente leitura. Isso só pode ser atualizado por Intune para qualquer tipo de sistema operacional de dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows. Suporta $filter (eq, ne, not).
isManaged Booliano truese o dispositivo for gerenciado por um aplicativo MDM (Mobile Gerenciamento de Dispositivos) ; caso contrário, false. Isso só pode ser atualizado por Intune para qualquer tipo de sistema operacional de dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows. Suporta $filter (eq, ne, not).
isManagementRestricted Booliano Indica se o dispositivo é membro de uma unidade administrativa de gerenciamento restrito, nesse caso, ele requer uma função no escopo da unidade administrativa restrita para gerenciar. O valor padrão é false. Somente leitura.

Para gerenciar um dispositivo que é membro de uma unidade administrativa restrita, o aplicativo de chamada deve receber a Directory.Write.Restricted permissão. Para cenários delegados, os administradores também devem receber funções com suporte explicitamente no escopo da unidade administrativa restrita.
isRooted Booliano true se o dispositivo estiver enraizado; false se o dispositivo estiver quebrado na cadeia. Essa propriedade só pode ser atualizada por Intune.
Tipo Cadeia de caracteres Fator de formulário do dispositivo. Retornado somente se o usuário entrar com uma conta microsoft como parte do Project Rome.
managementType Cadeia de caracteres Canal de gerenciamento do dispositivo. Essa 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 de aplicativo usado para registrar o dispositivo no 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. Retornada somente se o usuário entrar com uma conta da Microsoft como parte do Project Rome.
onPremisesLastSyncDateTime DateTimeOffset A última vez em que o objeto foi sincronizado com o diretório 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, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z somente leitura. Suporta $filter (eq, ne, not, ge, le, in).
onPremisesSecurityIdentifier String O SID (identificador de segurança local) para o usuário que foi sincronizado do local para a nuvem. 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 Dá suporte (eq, , notne, ge, le, startsWith, e eq em null valores).
operatingSystemVersion String A versão do sistema operacional do dispositivo. Obrigatório. $filter Dá suporte (eq, , notne, ge, le, startsWith, e eq em null valores).
physicalIds Coleção de cadeias de caracteres Apenas para uso interno. Não anulável. $filter Dá suporte (eq, , genot, , le, startsWith, /$count eq 0. /$count ne 0
plataforma Cadeia de caracteres Plataforma do dispositivo. Retornado somente se o usuário entrar com uma conta microsoft como parte do Project Rome.
profileType Cadeia de caracteres O tipo de perfil do dispositivo. Valores possíveis: RegisteredDevice (padrão), SecureVM, , Printer, Shared, IoT.
registrationDateTime DateTimeOffset Data e hora de quando o dispositivo foi registrado. O tipo de carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo 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. Retornada somente se o usuário entrar com uma conta da Microsoft como parte do Project Rome.
systemLabels Coleção String Lista de rótulos aplicados 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 trazer seus próprios dispositivos pessoais), AzureAd (dispositivos ingressados somente na nuvem) ServerAd (dispositivos ingressados no domínio local unidos a Microsoft Entra ID). Para obter mais informações, consulte Introdução ao gerenciamento 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 esse 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 esse dispositivo é membro. Essa operação é transitiva. Oferece suporte para $expand.
Direitosdeuso Coleção usageRight Representa os direitos de uso que um dispositivo recebeu.

Representação JSON

Veja a seguir uma representação JSON do 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": "Boolean",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "platform": "String",
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "status": "String",
  "systemLabels": ["String"],
  "trustType": "String"
}

Conteúdo relacionado