tipo de recurso de dispositivo
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. |
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. |
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 . Obrigatório. 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 , , not ne , ge , le e 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 do dispositivo Azure no momento do registro. Essa é uma chave alternativa que pode ser usada para fazer referência ao objeto do dispositivo. Suporta $filter (eq , ne , not , startsWith ). |
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 . |
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). |
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 | true se 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 | true se 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 ). |
fabricante | Cadeia de caracteres | Fabricante do dispositivo. Somente leitura. |
isRooted | Booliano | true se o dispositivo estiver enraizado; false se o dispositivo estiver quebrado na cadeia. Essa propriedade só pode ser atualizada por Intune. |
managementType | Cadeia de caracteres | O 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 . |
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. |
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 , , not ne , ge , le , startsWith , e eq em null valores). |
operatingSystemVersion | String | A versão do sistema operacional do dispositivo. Obrigatório. $filter Dá suporte (eq , , not ne , ge , le , startsWith , e eq em null valores). |
physicalIds | String collection | Apenas para uso interno. Não anulável. $filter Dá suporte (eq , , not , le ge , , startsWith ,/$count eq 0 , /$count ne 0 ). |
profileType | deviceProfileType | 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. |
systemLabels | String collection | 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 detalhes, confira Introdução ao gerenciamento de dispositivos no Microsoft Entra ID. |
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 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 o dispositivo é membro. Essa operação é transitiva. Suporta o $expand . |
Representação JSON
Veja a seguir uma representação JSON do recurso.
{
"accountEnabled": "Boolean",
"alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
"approximateLastSignInDateTime": "String (timestamp)",
"complianceExpirationDateTime": "String (timestamp)",
"deviceCategory": "String",
"deviceId": "String",
"deviceMetadata": "String",
"deviceOwnership": "String",
"deviceVersion": "Int32",
"displayName": "String",
"enrollmentProfileName": "String",
"enrollmentType": "String",
"extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
"id": "String (identifier)",
"isCompliant": "Boolean",
"isManaged": "Boolean",
"isRooted": "Boolean",
"managementType": "String",
"manufacturer": "String",
"mdmAppId": "String",
"model": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesSecurityIdentifier": "Boolean",
"onPremisesSyncEnabled": "Boolean",
"operatingSystem": "String",
"operatingSystemVersion": "String",
"physicalIds": ["String"],
"profileType": "String",
"registrationDateTime": "String (timestamp)",
"systemLabels": ["String"],
"trustType": "String"
}
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários