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 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 E-mails 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 Estado 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. 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 Estado de encriptação do dispositivo. 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 cartão 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 Administrador 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 O estado da proteção do dispositivo. 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"
}