Comentários Editar

tipo de recurso de dispositivo

  • Artigo
  • 6 minutos para o fim da leitura

Namespace: microsoft.graph

Representa um dispositivo registrado na organização. Dispositivos são criados na nuvem usando o Serviço de Registro de Dispositivo ou por meio do Intune. Eles são usados 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 as propriedades e os relacionamentos de um objeto device.
Listar dispositivos Coleção device Recupere uma lista de dispositivos registrados no diretório.
Atualizar dispositivo device Atualize as propriedades de um objeto device.
Excluir dispositivo Nenhuma Exclua um objeto device.
Listar memberOf Coleção directoryObject Liste os grupos e unidades administrativas dos qual o dispositivo é membro direto.
Listar memberOf transitivos Coleção directoryObject Liste os grupos e unidades administrativas dos qual o dispositivo é membro. Esta 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.
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 Coleção de cadeias de caracteres Retornar todos os grupos, unidades administrativas e funções de diretório dos qual 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 Funcionalidades avançadas de consulta nos objetos de diretório do Microsoft Azure AD.

Propriedade Tipo Descrição
accountEnabled Booliano true se a conta estiver habilitada; caso contrário, false. Obrigatório. O padrão é true.

Suporta $filter (eq, ne, not, in). Somente 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/hora 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. Dá $filter suporte a (eq, not``ne, ge, le, e eq em null valores) e $orderBy.
complianceExpirationDateTime DateTimeOffset O carimbo de data/hora quando o dispositivo não é mais considerado compatível. O tipo de carimbo de data/hora 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.
deviceId Cadeia de caracteres Identificador exclusivo definido pelo serviço de registro do dispositivo Azure no momento do registro. Suporta $filter (eq, ne, not, startsWith).
deviceMetadata String Apenas para uso interno. Definido como null
deviceVersion Int32 Apenas para uso interno.
displayName String O nome de exibição do dispositivo. Obrigatório. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores), $search, e $orderBy.
extensionAttributes onPremisesExtensionAttributes Contém atributos de extensão de 1 a 15 para o dispositivo. Os atributos de extensão individuais não são selecionáveis. Essas propriedades são dominadas na nuvem e podem ser definidas durante a criação ou atualização de um objeto de dispositivo Azure AD.

Suporte $filter (eq, not, startsWith, e eq no null valores).
id Cadeia de caracteres 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 do 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 do dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows. Suporta $filter (eq, ne, not).
fabricante String Fabricante do dispositivo. Somente leitura.
mdmAppId String Identificador de aplicativo usado para registrar o dispositivo no MDM. Somente leitura. Suporta $filter (eq, ne, not, startsWith).
modelo String Modelo do dispositivo. Somente leitura.
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).
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. Dá $filter suporte (eq, ne, not, ge, le, startsWithe em null eq valores).
operatingSystemVersion String A versão do sistema operacional do dispositivo. Obrigatório. Dá $filter suporte (eq, ne, not, ge, le, startsWithe em null eq valores).
physicalIds Coleção de cadeias de caracteres Apenas para uso interno. Não anulável. Dá $filter suporte (eq, not, ge, le, startsWithe contando coleções vazias).
profileType deviceProfileType O tipo de perfil do dispositivo. Valores possíveis: RegisteredDevice (padrão), SecureVM, Printer, Shared. IoT
systemLabels Coleção de cadeias de caracteres Lista de rótulos aplicados ao dispositivo pelo sistema. Dá $filter suporte (eq ao contar coleções vazias).
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 (somente dispositivos ingressados na nuvem) ServerAd (dispositivos ingressados no domínio local ingressados no Azure AD). Saiba mais em Introdução ao gerenciamento de dispositivo no Azure Active Directory

Relações

Relação Tipo Descrição
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 qual este dispositivo é membro. Somente leitura. Anulável. Suporta o $expand.
transitiveMemberOf Coleção directoryObject Grupos e unidades administrativas das qual o dispositivo é membro. Esta operação é transitiva. 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. Atualmente, só pode haver um proprietário. 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.

Representação JSON

Veja a seguir uma representação JSON do recurso

{
  "accountEnabled": true,
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "manufacturer": "string",
  "mdmAppId": "string",
  "model": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "string"
}

Confira também