Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |
| Retirar a ação | Nenhum | Desativar um dispositivo |
| Ação de apagamento | 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 | |
| Ação windowsDefenderScan | Nenhum | |
| Ação windowsDefenderUpdateSignatures | Nenhum | |
| Ação updateWindowsDeviceAccount | Nenhum |
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 | 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. Suporta $filter operador '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. Suporta $filter operador '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. Suporta $filter operador '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á desbloqueado ou com root. O padrão é uma cadeia de caracteres vazia. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| managementAgent | managementAgentType | Canal de gerenciamento do dispositivo. Exemplos: Intune, EAS etc. O padrão é desconhecido. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. Os valores possíveis são: eas, mdm, easMdm, intuneClientconfigurationManagerClientMdmconfigurationManagerClientMdmEasconfigurationManagerClienteasIntuneClient, , unknown, , . googleCloudDevicePolicyControllerjamf |
| 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, appleBulkWithUserwindowsAutoEnrollmentappleBulkWithoutUserwindowsCoManagementwindowsAzureADJoinappleUserEnrollmentwindowsBulkUserlesswindowsAzureADJoinUsingDeviceAuthwindowsBulkAzureDomainJoinappleUserEnrollmentWithServiceAccount. |
| 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 select. Suporta: $select. $Search 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, keyConflictapprovalPending, , certificateReset, , notRegisteredPendingEnrollment, . unknown |
| deviceCategoryDisplayName | Cadeia de caracteres | Nome de exibição da categoria de dispositivo. O padrão é uma cadeia de caracteres vazia. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| isSupervised | Booliano | status Dispositivo supervisionado. 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, exchangeIndividualRuleothercompliantnotCompliantnotEnrolledunknownLocationexchangeDeviceRuleazureADBlockDueToAccessPolicyexchangeUpgradedeviceNotKnownWithManagedAppexchangeMailboxPolicymfaRequiredcompromisedPassword, |
| 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 select. 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 do dispositivo. Essa propriedade é somente leitura. |
| userPrincipalName | Cadeia de caracteres | Nome UPN 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 | A data e hora em que 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 do 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 do assinante. 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 expiração 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 card SIM. 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 select. Suporta: $select. $Search 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 select. Suporta: $select. $Search não há suporte. Somente leitura. Essa propriedade é somente leitura. |
| notes | String | Anotações sobre o dispositivo criado pela Administração de TI. O padrão é null. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro select. Suporta: $select. $Search não há suporte. |
| ethernetMacAddress | Cadeia de caracteres | Indica o endereço MAC Ethernet do dispositivo. Padrão, é Null (propriedade não padrão) para essa propriedade quando retornada como parte da entidade managedDevice. A chamada de obtenção individual com opções de consulta selecionadas é necessária para recuperar valores reais. Exemplo: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Suporta: $select. $Search 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 select. Suporta: $select. Somente leitura. Essa propriedade é somente leitura. |
| enrollmentProfileName | Cadeia de caracteres | Nome do perfil de registro atribuído ao dispositivo. O valor padrão é cadeia de caracteres vazia, indicando que nenhum perfil de registro foi atribuído. Essa propriedade é somente leitura. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| 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 log |
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"
}