Tipo de recurso managedDevice

  • Artigo

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Dispositivos gerenciados ou pré-registrados pelo Intune

Métodos

Método Tipo de retorno Descrição
Listar managedDevices Conjunto managedDevice Listar propriedades e relações dos objetos managedDevice.
Obter managedDevice managedDevice Ler propriedades e relações de objetos de managedDevice.
Criar managedDevice managedDevice Criar um novo objeto managedDevice.
Excluir managedDevice Nenhum Excluir um managedDevice
Atualizar managedDevice managedDevice Atualizar as propriedades de um objeto managedDevice.

|ação retire|Nenhum|Retirar um dispositivo| |ação wipe|Nenhum|Apagar um dispositivo| |ação resetPasscode|Nenhum|Redefinir senha| |ação remoteLock|Nenhum|Bloqueio remoto| |ação requestRemoteAssistance|Nenhum|Solicitar assistência remota| |ação disableLostMode|Nenhum|Desabilitar o modo perdido| |ação locateDevice|Nenhum|Localizar um dispositivo| |ação bypassActivationLock|Nenhum|Bloqueio de ativação de bypass| |ação rebootNow|Nenhum|Reinicializar dispositivo| |ação shutDown|Nenhum|Desligar dispositivo| |ação recoverPasscode|Nenhum|Recuperar senha| |ação cleanWindowsDevice|Nenhum|Limpar dispositivo Windows| |logoutSharedAppleDeviceActiveUser ação|Nenhum|Logout compartilhado usuário ativo do dispositivo Apple| |ação deleteUserFromSharedAppleDevice|Nenhum|Excluir usuário do dispositivo Apple compartilhado| |ação syncDevice|Nenhum|| |ação windowsDefenderScan|Nenhum|| |ação windowsDefenderUpdateSignatures|Nenhum|| |ação updateWindowsDeviceAccount|Nenhum||

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador Exclusivo para o dispositivo. Essa propriedade é somente leitura.
userId Cadeia de caracteres Identificador Exclusivo para o usuário associado ao dispositivo. Essa propriedade é somente leitura.
deviceName Cadeia de caracteres Nome do dispositivo. Essa propriedade é somente leitura.
managedDeviceOwnerType managedDeviceOwnerType Propriedade do dispositivo. Pode ser "empresa" ou "pessoal". Os valores possíveis são: unknown, company, personal.
deviceActionResults Coleção deviceActionResult Lista de objetos ComplexType deviceActionResult. Essa propriedade é somente leitura.
enrolledDateTime DateTimeOffset Hora de registro do dispositivo. Dá suporte ao operador $filter 'lt' e 'gt'. Essa propriedade é somente leitura.
lastSyncDateTime DateTimeOffset A data e a hora da última vez em que o dispositivo concluiu uma sincronização bem-sucedida com o Intune. Dá suporte ao operador $filter 'lt' e 'gt'. Essa propriedade é somente leitura.
operatingSystem String Sistema operacional do dispositivo. Windows, iOS etc. Essa propriedade é somente leitura.
complianceState complianceState Estado de conformidade do dispositivo. Exemplos: Compatível, Conflito, Erro etc. O padrão é desconhecido. Dá suporte ao operador $filter 'eq' e 'or'. Essa propriedade é somente leitura. Os valores possíveis são: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBroken Cadeia de caracteres Se o dispositivo está quebrado ou enraizado na cadeia. O padrão é uma cadeia de caracteres vazia. Dá suporte ao operador $filter 'eq' e 'or'. Essa propriedade é somente leitura.
managementAgent managementAgentType Canal de gerenciamento do dispositivo. Exemplos: Intune, EAS etc. O padrão é desconhecido. Dá suporte ao operador $filter 'eq' e 'or'. Essa propriedade é somente leitura. Os valores possíveis são: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
osVersion String A versão do sistema operacional do dispositivo. Essa propriedade é somente leitura.
easActivated Boolean Se o dispositivo está ativado para Exchange ActiveSync. Essa propriedade é somente leitura.
easDeviceId String ID do Exchange ActiveSync do dispositivo. Essa propriedade é somente leitura.
easActivationDateTime DateTimeOffset Hora de ativação do Exchange ActiveSync do dispositivo. Essa propriedade é somente leitura.
azureADRegistered Boolean Se o dispositivo é registrado no Azure Active Directory. Essa propriedade é somente leitura.
deviceEnrollmentType deviceEnrollmentType Tipo de registro do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment e appleUserEnrollmentWithServiceAccount.
activationLockBypassCode Cadeia de caracteres O código que permite que o Bloqueio de Ativação no dispositivo gerenciado seja ignorado. Padrão, é Null (propriedade Não Padrão) para essa propriedade quando retornada como parte da entidade managedDevice na chamada LIST. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Dá suporte: $select. $Pesquisa não há suporte. Somente leitura. Essa propriedade é somente leitura.
emailAddress Cadeia de caracteres Email(s) para o usuário associado ao dispositivo. Essa propriedade é somente leitura.
azureADDeviceId String O identificador exclusivo do dispositivo do Azure Active Directory. Somente leitura. Essa propriedade é somente leitura.
deviceRegistrationState deviceRegistrationState Estado do registro do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayName Cadeia de caracteres Nome de exibição da categoria do dispositivo. O padrão é uma cadeia de caracteres vazia. Dá suporte ao operador $filter 'eq' e 'or'. Essa propriedade é somente leitura.
isSupervised Booliano Dispositivo supervisionado status. Essa propriedade é somente leitura.
exchangeLastSuccessfulSyncDateTime DateTimeOffset Última vez em que o dispositivo entrou em contato com o Exchange. Essa propriedade é somente leitura.
exchangeAccessState deviceManagementExchangeAccessState O estado de acesso do dispositivo no Exchange. Essa propriedade é somente leitura. Os valores possíveis são: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReason deviceManagementExchangeAccessStateReason A razão para o estado de acesso do dispositivo no Exchange. Essa propriedade é somente leitura. Os valores possíveis são: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrl String A URL que permite que uma sessão de assistência remota seja estabelecida com o dispositivo. O padrão é uma cadeia de caracteres vazia. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Essa propriedade é somente leitura.
remoteAssistanceSessionErrorDetails String Uma cadeia de caracteres de erro que identifica problemas durante a criação de objetos de sessão de Assistência remota. Essa propriedade é somente leitura.
isEncrypted Booliano Status de criptografia de dispositivo. Essa propriedade é somente leitura.
userPrincipalName Cadeia de caracteres Nome da entidade de usuário do dispositivo. Essa propriedade é somente leitura.
modelo Cadeia de caracteres Modelo do dispositivo. Essa propriedade é somente leitura.
fabricante Cadeia de caracteres Fabricante do dispositivo. Essa propriedade é somente leitura.
imei Cadeia de caracteres IMEI. Essa propriedade é somente leitura.
complianceGracePeriodExpirationDateTime DateTimeOffset O DateTime quando o período de carência de conformidade do dispositivo expira. Essa propriedade é somente leitura.
serialNumber Cadeia de caracteres Serialnumber. Essa propriedade é somente leitura.
phoneNumber Cadeia de caracteres Número de telefone do dispositivo. Essa propriedade é somente leitura.
androidSecurityPatchLevel Cadeia de caracteres Nível de patch de segurança do Android. Essa propriedade é somente leitura.
userDisplayName Cadeia de caracteres Nome de exibição do usuário. Essa propriedade é somente leitura.
configurationManagerClientEnabledFeatures configurationManagerClientEnabledFeatures Recursos habilitados para cliente configrMgr. Essa propriedade é somente leitura.
wiFiMacAddress Cadeia de caracteres Wi-Fi MAC. Essa propriedade é somente leitura.
deviceHealthAttestationState deviceHealthAttestationState O estado do atestado de integridade do dispositivo. Essa propriedade é somente leitura.
subscriberCarrier Cadeia de caracteres Operadora de Assinantes. Essa propriedade é somente leitura.
meid Cadeia de caracteres MEID. Essa propriedade é somente leitura.
totalStorageSpaceInBytes Int64 Armazenamento Total em Bytes. Essa propriedade é somente leitura.
freeStorageSpaceInBytes Int64 Armazenamento gratuito em Bytes. O valor padrão é 0. Somente leitura. Essa propriedade é somente leitura.
managedDeviceName String Nome gerado automaticamente para identificar um dispositivo. Pode ser substituído por um nome amigável ao usuário.
partnerReportedThreatState managedDevicePartnerReportedHealthState Indica o estado de ameaças de um dispositivo quando um parceiro de Defesa contra ameaças móveis está em uso pela conta e pelo dispositivo. Somente leitura. Essa propriedade é somente leitura. Os valores possíveis são: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.
requireUserEnrollmentApproval Booliano Relata se o dispositivo iOS gerenciado é o registro de aprovação do usuário. Essa propriedade é somente leitura.
managementCertificateExpirationDate DateTimeOffset Relata a data de validade do certificado de gerenciamento de dispositivo. Essa propriedade é somente leitura.
iccid Cadeia de caracteres Identificador de cartão de circuito integrado, é o número de identificação exclusivo de um sim cartão. O padrão é uma cadeia de caracteres vazia. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Dá suporte: $select. $Pesquisa não há suporte. Somente leitura. Essa propriedade é somente leitura.
Udid Cadeia de caracteres Identificador de dispositivo exclusivo para dispositivos iOS e macOS. O padrão é uma cadeia de caracteres vazia. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Dá suporte: $select. $Pesquisa não há suporte. Somente leitura. Essa propriedade é somente leitura.
notes String Anotações sobre o dispositivo criado pelo Administração de TI. O padrão é nulo. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Dá suporte: $select. $Pesquisa não há suporte.
ethernetMacAddress Cadeia de caracteres Indica o endereço MAC do Ethernet do dispositivo. Padrão, é Null (propriedade Não Padrão) para essa propriedade quando retornada como parte da entidade managedDevice. A chamada individual com opções de consulta selecionadas é necessária para recuperar valores reais. Exemplo: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Pesquisa não há suporte. Somente leitura. Essa propriedade é somente leitura.
physicalMemoryInBytes Int64 Memória total em Bytes. O padrão é 0. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro de seleção. Dá suporte: $select. Somente leitura. Essa propriedade é somente leitura.
enrollmentProfileName Cadeia de caracteres Nome do perfil de registro atribuído ao dispositivo. O valor padrão é uma cadeia de caracteres vazia, indicando que nenhum perfil de registro foi assginado. Essa propriedade é somente leitura.

Relações

Relação Tipo Descrição
deviceCategory deviceCategory Categoria do dispositivo
windowsProtectionState windowsProtectionState A proteção do dispositivo status. Essa propriedade é somente leitura.
usuários Coleção user Os usuários primários associados ao dispositivo gerenciado.
logCollectionRequests coleção deviceLogCollectionResponse Lista de solicitações de coleção de logs

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "String (identifier)",
  "userId": "String",
  "deviceName": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "String",
  "azureADDeviceId": "String",
  "deviceRegistrationState": "String",
  "deviceCategoryDisplayName": "String",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
  "exchangeAccessState": "String",
  "exchangeAccessStateReason": "String",
  "remoteAssistanceSessionUrl": "String",
  "remoteAssistanceSessionErrorDetails": "String",
  "isEncrypted": true,
  "userPrincipalName": "String",
  "model": "String",
  "manufacturer": "String",
  "imei": "String",
  "complianceGracePeriodExpirationDateTime": "String (timestamp)",
  "serialNumber": "String",
  "phoneNumber": "String",
  "androidSecurityPatchLevel": "String",
  "userDisplayName": "String",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "String",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "String",
    "contentNamespaceUrl": "String",
    "deviceHealthAttestationStatus": "String",
    "contentVersion": "String",
    "issuedDateTime": "String (timestamp)",
    "attestationIdentityKey": "String",
    "resetCount": 1024,
    "restartCount": 1024,
    "dataExcutionPolicy": "String",
    "bitLockerStatus": "String",
    "bootManagerVersion": "String",
    "codeIntegrityCheckVersion": "String",
    "secureBoot": "String",
    "bootDebugging": "String",
    "operatingSystemKernelDebugging": "String",
    "codeIntegrity": "String",
    "testSigning": "String",
    "safeMode": "String",
    "windowsPE": "String",
    "earlyLaunchAntiMalwareDriverProtection": "String",
    "virtualSecureMode": "String",
    "pcrHashAlgorithm": "String",
    "bootAppSecurityVersion": "String",
    "bootManagerSecurityVersion": "String",
    "tpmVersion": "String",
    "pcr0": "String",
    "secureBootConfigurationPolicyFingerPrint": "String",
    "codeIntegrityPolicy": "String",
    "bootRevisionListInfo": "String",
    "operatingSystemRevListInfo": "String",
    "healthStatusMismatchInfo": "String",
    "healthAttestationSupportedStatus": "String"
  },
  "subscriberCarrier": "String",
  "meid": "String",
  "totalStorageSpaceInBytes": 1024,
  "freeStorageSpaceInBytes": 1024,
  "managedDeviceName": "String",
  "partnerReportedThreatState": "String",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "notes": "String",
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "enrollmentProfileName": "String"
}