Tipo de recurso managedDevice
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 de extinção|Nenhum|Extinguir um dispositivo| |ação de eliminação|Nenhum|Apagar um dispositivo| |resetPasscode action|Nenhum|Repor código de acesso| |ação remoteLock|Nenhum|Bloqueio remoto| |ação requestRemoteAssistance|Nenhum|Pedir assistência remota| |disableLostMode action|Nenhum|Desativar o modo perdido| |locateDevice action|Nenhum|Localizar um dispositivo| |bypassActivationLock action|Nenhum|Ignorar bloqueio de ativação| |ação rebootNow|Nenhum|Reiniciar dispositivo| |ação encerrar|Nenhum|Encerrar dispositivo| |recoverPasscode action|Nenhum|Recuperar código de acesso| |cleanWindowsDevice action|Nenhum|Limpar dispositivo Windows| |logoutSharedAppleDeviceActiveUser action|Nenhum|Terminar sessão do utilizador ativo do dispositivo Apple partilhado| |deleteUserFromSharedAppleDevice action|Nenhum|Eliminar utilizadores de dispositivos Apple partilhados| |syncDevice action|Nenhum|| |ação windowsDefenderScan|Nenhum|| |windowsDefenderUpdateSignatures action|Nenhum|| |updateWindowsDeviceAccount action|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 utilizador 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. Esta propriedade é só de leitura. |
| complianceState | complianceState | Estado de conformidade do dispositivo. Exemplos: Conforme, Conflito, Erro, etc. A predefinição é desconhecida. Suporta $filter operador "eq" e "ou". 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 por jailbreak ou rooting. O padrão é uma cadeia de caracteres vazia. Suporta $filter operador "eq" e "ou". Essa propriedade é somente leitura. |
| managementAgent | managementAgentType | Canal de gerenciamento do dispositivo. Exemplos: Intune, EAS, etc. A predefinição é desconhecida. Suporta $filter operador "eq" e "ou". 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 ignorar o Bloqueio de Ativação no dispositivo gerido. Predefinição, é Nulo (propriedade Não Predefinida) para esta propriedade quando devolvida como parte da entidade managedDevice na chamada LIST. Para obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído no parâmetro select. Suporta: $select. $Search não é suportado. Somente leitura. Essa propriedade é somente leitura. |
| emailAddress | Cadeia de caracteres | Email para o utilizador 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 a apresentar da categoria do dispositivo. O padrão é uma cadeia de caracteres vazia. Suporta $filter operador "eq" e "ou". 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 obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído 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 encriptação de dispositivos. Essa propriedade é somente leitura. |
| userPrincipalName | Cadeia de caracteres | Nome principal de utilizador 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 tolerâ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 a apresentar do utilizador. Essa propriedade é somente leitura. |
| configurationManagerClientEnabledFeatures | configurationManagerClientEnabledFeatures | Funcionalidades ativadas pelo cliente do 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 subscritora. 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 | Comunica se o dispositivo iOS gerido é a inscrição de aprovação de utilizadores. Essa propriedade é somente leitura. |
| managementCertificateExpirationDate | DateTimeOffset | Comunica a data de expiração do certificado de gestão de dispositivos. 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 obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído no parâmetro select. Suporta: $select. $Search não é suportado. 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 obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído no parâmetro select. Suporta: $select. $Search não é suportado. Somente leitura. Essa propriedade é somente leitura. |
| notes | String | Notas no dispositivo criado pelo Administração de TI. A predefinição é nula. Para obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído no parâmetro select. Suporta: $select. $Search não é suportado. |
| ethernetMacAddress | Cadeia de caracteres | Indica o Endereço MAC Ethernet do dispositivo. Predefinição, é Nulo (propriedade Não Predefinida) para esta propriedade quando devolvida como parte da entidade managedDevice. É necessária uma chamada individual com opções de consulta selecionadas para obter os valores reais. Exemplo: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search não é suportado. Somente leitura. Essa propriedade é somente leitura. |
| physicalMemoryInBytes | Int64 | Memória Total em Bytes. O padrão é 0. Para obter os valores reais, a chamada GET tem de ser efetuada, com o ID do dispositivo e incluído no parâmetro select. Suporta: $select. Somente leitura. Essa propriedade é somente leitura. |
| enrollmentProfileName | Cadeia de caracteres | Nome do perfil de inscrição atribuído ao dispositivo. O valor predefinido é uma cadeia vazia, que indica que não foi sessão iniciada nenhum perfil de inscrição. 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 principais utilizadores associados ao dispositivo gerido. |
| logCollectionRequests | deviceLogCollectionResponse collection | Lista de pedidos de recolha de registos |
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"
}