Tipo de recurso managedDevice

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

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
Obter managedDevice managedDevice Ler propriedades e relações de objetos de managedDevice.
Atualizar managedDevice managedDevice Atualizar as propriedades de um objeto managedDevice.
Ação executeAction bulkManagedDeviceActionResult Ainda não documentado
Ação enableLostMode Nenhum Habilitar o modo perdido
Ação playLostModeSound Nenhum Reproduzir som de modo perdido
Ação setDeviceName Nenhum Defina o nome do dispositivo.
Ação activateDeviceEsim Nenhum Ative o eSIM no dispositivo.
Ação rotateFileVaultKey Nenhuma Ainda não documentado
Função getFileVaultKey String Ainda não documentado
Ação createDeviceLogCollectionRequest deviceLogCollectionResponse Ainda não documentado
Ação retire Nenhum Desativar 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 Ignorar bloqueio de ativação
Ação rebootNow Nenhum Reiniciar dispositivo
Ação shutDown Nenhum Desligar dispositivo
Ação recoverPasscode Nenhum Recuperar senha
Ação cleanWindowsDevice Nenhum Limpar dispositivo Windows
Ação logoutSharedAppleDeviceActiveUser Nenhum Sair do usuário ativo no dispositivo Apple compartilhado
Ação deleteUserFromSharedAppleDevice Nenhum Excluir o usuário do dispositivo compartilhado da Apple
Ação syncDevice Nenhum Ainda não documentado
Ação windowsDefenderScan Nenhum Ainda não documentado
Ação windowsDefenderUpdateSignatures Nenhum Ainda não documentado
Ação updateWindowsDeviceAccount Nenhum Ainda não documentado
Ação revokeAppleVppLicenses Nenhum Revogar todas as licenças do Apple Vpp para um dispositivo
Ação rotateBitLockerKeys Nenhum Girar BitLockerKeys
ação sendCustomNotificationToCompanyPortal Nenhuma Ainda não documentado
Ação triggerConfigurationManagerAction Nenhum Ação de gatilho no cliente ConfigurationManager
ação de desprovisionamento Nenhuma Ainda não documentado
desabilitar ação Nenhuma Ainda não documentado
ação reabilitada Nenhuma Ainda não documentado
Ação moveDevicesToOU Nenhuma Ainda não documentado
Ação removeDeviceFirmwareConfigurationInterfaceManagement Nenhum Remover o dispositivo do gerenciamento da Interface de Configuração do Firmware do Dispositivo
Função getOemWarranty oemWarranty Ainda não documentado

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador exclusivo do dispositivo. Essa propriedade é somente leitura.
userId Cadeia de caracteres Identificador Exclusivo para o usuário associado ao dispositivo. Essa propriedade é somente leitura.
deviceName String Nome do dispositivo. Essa propriedade é somente leitura.
hardwareInformation hardwareInformation Os detalhes rígidos do dispositivo. Inclui informações como espaço de armazenamento, fabricante, número de série etc. Essa propriedade é somente leitura.
Ownertype Ownertype Propriedade do dispositivo. Pode ser "empresa" ou "pessoal". Os valores possíveis são: unknown, company, personal.
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.
managementState managementState Estado de gerenciamento do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: managed, retirePending, retireFailed, wipePending, wipeFailed, unhealthy, deletePending, retireIssued, wipeIssued, wipeCanceled, retireCanceled, discovered.
enrolledDateTime DateTimeOffset Hora de registro do dispositivo. 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. Essa propriedade é somente leitura.
chassisType chassisType Tipo de chassi do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: unknown, desktop, laptop, worksWorkstation, enterpriseServer, phone, tablet, mobileOther, mobileUnknown.
operatingSystem String Sistema operacional do dispositivo. Windows, iOS, etc. Essa propriedade é somente leitura.
deviceType Devicetype Plataforma do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: , , , , , , , winCE, iPod``cloudPC``palm``macMDM``blackberry``unix``linux``iSocConsumer``unknown``windows10x``androidnGMS``iPad``chromeOS``androidEnterprise``androidForWork``surfaceHub``holoLens``android``iPhone``winEmbedded. windowsPhone``mac``nokia``winMO6``windowsRT``desktop
complianceState complianceState Estado de conformidade do dispositivo. Essa propriedade é somente leitura. Os valores possíveis são: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBroken String se o dispositivo está desbloqueado ou modificado. Essa propriedade é somente leitura.
managementAgent managementAgentType Canal de gerenciamento do dispositivo. Intune, EAS, etc. Essa propriedade é somente leitura. Os valores possíveis são: , , , , , , , configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, , googleCloudDevicePolicyController, msSense``microsoft365ManagedMdm, . intuneAosp``configurationManagerClient``easIntuneClient``intuneClient``easMdm``mdm``eas
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.
aadRegistered Boolean Se o dispositivo é registrado no Azure Active Directory. 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: , , , , , , , , windowsBulkUserless``windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment, , appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, , androidEnterpriseDedicatedDevice``androidEnterpriseFullyManaged. androidEnterpriseCorporateWorkProfile``windowsAzureADJoin``appleBulkWithUser``appleBulkWithoutUser``deviceEnrollmentManager``userEnrollment``unknown
lostModeState lostModeState Indica se o modo Perdido está habilitado ou desabilitado. Essa propriedade é somente leitura. Os valores possíveis são: disabled e enabled.
activationLockBypassCode String Código que permite que o Bloqueio de Ativação em um dispositivo seja ignorado. Essa propriedade é somente leitura.
emailAddress String Email(s) para o usuário associado ao dispositivo. Essa propriedade é somente leitura.
azureActiveDirectoryDeviceId String O identificador exclusivo do dispositivo do Azure Active Directory. Somente leitura. 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 String Nome de exibição da categoria de dispositivo. Essa propriedade é somente leitura.
isSupervised Boolean Status supervisionado do dispositivo. 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. 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 Boolean Status de criptografia do dispositivo. Essa propriedade é somente leitura.
userPrincipalName Cadeia de caracteres Nome principal do usuário do dispositivo. Essa propriedade é somente leitura.
modelo String Modelo do dispositivo. Essa propriedade é somente leitura.
fabricante String Fabricante do dispositivo. Essa propriedade é somente leitura.
imei String 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 String Serialnumber. Essa propriedade é somente leitura.
phoneNumber String Número de telefone do dispositivo. Essa propriedade é somente leitura.
androidSecurityPatchLevel String 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 do ConfigrMgr. Essa propriedade é somente leitura.
wiFiMacAddress String Wi-Fi MAC. Essa propriedade é somente leitura.
deviceHealthAttestationState deviceHealthAttestationState O estado do atestado de integridade do dispositivo. Essa propriedade é somente leitura.
subscriberCarrier String Operadora do Assinante. Essa propriedade é somente leitura.
meid String MEID. Essa propriedade é somente leitura.
totalStorageSpaceInBytes Int64 Armazenamento total em bytes. Essa propriedade é somente leitura.
freeStorageSpaceInBytes Int64 Armazenamento gratuito em bytes. 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.
retireAfterDateTime DateTimeOffset Indica o tempo após o momento em que um dispositivo será desativado automaticamente devido à ação agendada. Essa propriedade é somente leitura.
usersLoggedOn coleção loggedOnUser Indica os últimos usuários conectados de um dispositivo. Essa propriedade é somente leitura.
preferMdmOverGroupPolicyAppliedDateTime DateTimeOffset Relata o DateTime que a configuração preferMdmOverGroupPolicy foi definida. Quando definido, as Intune de MDM substituirão Política de Grupo configurações se houver um conflito. Somente leitura. Essa propriedade é somente leitura.
autopilotEnrolled Boolean Relata se o dispositivo gerenciado está registrado por meio do piloto automático. Essa propriedade é somente leitura.
requireUserEnrollmentApproval Boolean 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 String Identificador de Placa de Circuito Integrado, é o número de identificação exclusivo de um cartão SIM. Essa propriedade é somente leitura.
Udid String Identificador de Dispositivo Exclusivo para dispositivos iOS e macOS. Essa propriedade é somente leitura.
roleScopeTagIds String collection Lista de IDs de marca de escopo para esta instância do dispositivo.
windowsActiveMalwareCount Int32 Contagem de malware ativo para este dispositivo Windows. Essa propriedade é somente leitura.
windowsRemediatedMalwareCount Int32 Contagem de malware corrigido para este dispositivo Windows. Essa propriedade é somente leitura.
notes String Observações sobre o dispositivo criado pelo Administração
configurationManagerClientHealthState configurationManagerClientHealthState Estado de integridade do cliente do Configuration Manager, válido somente para dispositivos gerenciados pelo agente MDM/ConfigMgr
configurationManagerClientInformation configurationManagerClientInformation Informações do cliente do Configuration Manager, válidas somente para dispositivos gerenciados, gerenciados por duelo ou trigerenciados pelo Agente do ConfigMgr
ethernetMacAddress Cadeia de caracteres Ethernet MAC. Essa propriedade é somente leitura.
physicalMemoryInBytes Int64 Memória total em bytes. Essa propriedade é somente leitura.
Processorarchitecture managedDeviceArchitecture Arquitetura do processador. Essa propriedade é somente leitura. Os valores possíveis são: unknown, x86, x64, arm, arM64.
specificationVersion String Versão de especificação. Essa propriedade é somente leitura.
joinType joinType Tipo de junção de dispositivo. Os valores possíveis são: unknown, azureADJoined, azureADRegistered, hybridAzureADJoined.
skuFamily Cadeia de caracteres Família de SKU do dispositivo
skuNumber Int32 Número de SKU do dispositivo, consulte também: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valores válidos de 0 a 2147483647. Essa propriedade é somente leitura.
managementFeatures managedDeviceManagementFeatures Recursos de gerenciamento de dispositivos. Os valores possíveis são: none e microsoftManagedDesktop.
chromeOSDeviceInfo Coleção chromeOSDeviceProperty Lista de propriedades do dispositivo ChromeOS.
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 atribuído. Essa propriedade é somente leitura.
bootstrapTokenEscrowed Boolean Relata se o dispositivo gerenciado tem um token de inicialização escrotado. Isso é apenas para dispositivos macOS. Se FOR FALSO, nenhum token de inicialização será emitido. Se TRUE, o dispositivo escroou um token de inicialização com Intune. Essa propriedade é somente leitura.
deviceFirmwareConfigurationInterfaceManaged Boolean Indica se o dispositivo é gerenciado pela DFCI. Quando TRUE, o dispositivo é gerenciado pela DFCI. Quando FALSE, o dispositivo não é gerenciado pela DFCI. O valor padrão é FALSO.

Relações

Relação Tipo Descrição
detectedApps Conjunto detectedApp Todos os aplicativos atualmente instalados no dispositivo
deviceCategory deviceCategory Categoria do dispositivo
windowsProtectionState windowsProtectionState O status de proteção do dispositivo. 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 coleta 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",
  "hardwareInformation": {
    "@odata.type": "microsoft.graph.hardwareInformation",
    "serialNumber": "String",
    "totalStorageSpace": 1024,
    "freeStorageSpace": 1024,
    "imei": "String",
    "meid": "String",
    "manufacturer": "String",
    "model": "String",
    "phoneNumber": "String",
    "subscriberCarrier": "String",
    "cellularTechnology": "String",
    "wifiMac": "String",
    "operatingSystemLanguage": "String",
    "isSupervised": true,
    "isEncrypted": true,
    "batterySerialNumber": "String",
    "batteryHealthPercentage": 1024,
    "batteryChargeCycles": 1024,
    "isSharedDevice": true,
    "sharedDeviceCachedUsers": [
      {
        "@odata.type": "microsoft.graph.sharedAppleDeviceUser",
        "userPrincipalName": "String",
        "dataToSync": true,
        "dataQuota": 1024,
        "dataUsed": 1024
      }
    ],
    "tpmSpecificationVersion": "String",
    "operatingSystemEdition": "String",
    "deviceFullQualifiedDomainName": "String",
    "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "String",
    "deviceGuardVirtualizationBasedSecurityState": "String",
    "deviceGuardLocalSystemAuthorityCredentialGuardState": "String",
    "osBuildNumber": "String",
    "operatingSystemProductType": 1024,
    "ipAddressV4": "String",
    "subnetAddress": "String",
    "esimIdentifier": "String",
    "systemManagementBIOSVersion": "String",
    "tpmManufacturer": "String",
    "tpmVersion": "String",
    "wiredIPv4Addresses": [
      "String"
    ],
    "batteryLevelPercentage": "4.2",
    "residentUsersCount": 1024,
    "productName": "String",
    "deviceLicensingStatus": "String",
    "deviceLicensingLastErrorCode": 1024,
    "deviceLicensingLastErrorDescription": "String"
  },
  "ownerType": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "managementState": "String",
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "chassisType": "String",
  "operatingSystem": "String",
  "deviceType": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "aadRegistered": true,
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "lostModeState": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "String",
  "azureActiveDirectoryDeviceId": "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,
    "endpointProtection": true,
    "officeApps": 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",
  "retireAfterDateTime": "String (timestamp)",
  "usersLoggedOn": [
    {
      "@odata.type": "microsoft.graph.loggedOnUser",
      "userId": "String",
      "lastLogOnDateTime": "String (timestamp)"
    }
  ],
  "preferMdmOverGroupPolicyAppliedDateTime": "String (timestamp)",
  "autopilotEnrolled": true,
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "roleScopeTagIds": [
    "String"
  ],
  "windowsActiveMalwareCount": 1024,
  "windowsRemediatedMalwareCount": 1024,
  "notes": "String",
  "configurationManagerClientHealthState": {
    "@odata.type": "microsoft.graph.configurationManagerClientHealthState",
    "state": "String",
    "errorCode": 1024,
    "lastSyncDateTime": "String (timestamp)"
  },
  "configurationManagerClientInformation": {
    "@odata.type": "microsoft.graph.configurationManagerClientInformation",
    "clientIdentifier": "String",
    "isBlocked": true
  },
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "processorArchitecture": "String",
  "specificationVersion": "String",
  "joinType": "String",
  "skuFamily": "String",
  "skuNumber": 1024,
  "managementFeatures": "String",
  "chromeOSDeviceInfo": [
    {
      "@odata.type": "microsoft.graph.chromeOSDeviceProperty",
      "name": "String",
      "value": "String",
      "valueType": "String",
      "updatable": true
    }
  ],
  "enrollmentProfileName": "String",
  "bootstrapTokenEscrowed": true,
  "deviceFirmwareConfigurationInterfaceManaged": true
}