Atualizar managedDevice

Artigo
08/02/2024

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

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

Atualizar as propriedades de um objeto managedDevice.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/comanagedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto managedDevice.

A tabela a seguir mostra as propriedades que são necessárias ao criar managedDevice.

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.
hardwareInformation	hardwareInformation	Os detalhes para o dispositivo. Inclui informações como espaço de armazenamento, fabricante, número de série, etc. Por predefinição, a maioria das propriedades deste tipo estão definidas como null/0/false e enumeram predefinições para tipos associados. 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.
ownerType	ownerType	Propriedade do dispositivo. Os valores possíveis são "empresa" ou "pessoal". A predefinição é desconhecida. Suporta $filter operador "eq" e "ou". 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 gestão do dispositivo. Exemplos: Gerido, Extinguir Pendente, etc. A predefinição é gerida. Suporta $filter operador "eq" e "ou". 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. 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.
chassisType	chassisType	Tipo de chassis 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. Esta propriedade é só de leitura.
deviceType	deviceType	Plataforma do dispositivo. Exemplos: Desktop, WindowsRT, etc. A predefinição é desconhecida. Suporta $filter operador "eq" e "ou". Essa propriedade é somente leitura. Os valores possíveis são: `desktop`, , `windowsRT`, `winMO6nokia`, `windowsPhone`, `mac`, `winCEwinEmbedded`, , `iPhone`, `iPad`, `iPod`, `android`, `iSocConsumer`, `holoLensunixmacMDM`, `surfaceHub`, `androidForWork`, , `androidEnterprise`, `windows10x`, , `linuxchromeOScloudPCandroidnGMSblackberrypalmunknown`, .
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`, `microsoft365ManagedMdm`, `msSense`, `intuneAosp`, `google`, `unknownFutureValue`.
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	Booliano	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: `unknown`, , `userEnrollment`, `appleBulkWithUserdeviceEnrollmentManager`, `appleBulkWithoutUser`, `windowsAzureADJoin`, `windowsBulkUserlesswindowsAutoEnrollment`, , `windowsBulkAzureDomainJoin`, `windowsCoManagement`, `windowsAzureADJoinUsingDeviceAuth`, `appleUserEnrollment`, `appleUserEnrollmentWithServiceAccount`, , `azureAdJoinUsingAzureVmExtension`, `androidEnterpriseDedicatedDevice`, , `androidEnterpriseFullyManaged`, , `androidEnterpriseCorporateWorkProfile`, , `appleACMEBasicBYOD`, `appleACMEDEPUDAModernAuthappleACMEDEPUserlessappleACMEDEPUDACompanyPortalappleACMEDEPUDASetupAsstLegacy`.
lostModeState	lostModeState	Indica se o Modo perdido está ativado ou desativado. Essa propriedade é somente leitura. Os valores possíveis são: `disabled` e `enabled`.
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.
azureActiveDirectoryDeviceId	Cadeia de caracteres	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	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`.
retireAfterDateTime	DateTimeOffset	Indica a hora após a qual um dispositivo será descontinuado automaticamente devido à ação agendada. Essa propriedade é somente leitura.
usersLoggedOn	coleção loggedOnUser	Indica os últimos utilizadores com sessão iniciada de um dispositivo. Essa propriedade é somente leitura.
preferMdmOverGroupPolicyAppliedDateTime	DateTimeOffset	Comunica que a definição preferMdmOverGroupPolicy foi definida em DateTime. Quando definidas, as definições de MDM do Intune substituirão as definições da Política de Grupo se existir um conflito. Somente leitura. Essa propriedade é somente leitura.
autopilotEnrolled	Booliano	Comunica se o dispositivo gerido está inscrito através do piloto automático. Essa propriedade é somente leitura.
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.
roleScopeTagIds	String collection	Lista de IDs de Etiquetas de Âmbito para esta Instância de dispositivo.
windowsActiveMalwareCount	Int32	Contagem de software maligno ativo para este dispositivo Windows. 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. Essa propriedade é somente leitura.
windowsRemediatedMalwareCount	Int32	Contagem de software maligno remediado para este dispositivo Windows. 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. 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.
configurationManagerClientHealthState	configurationManagerClientHealthState	Estado de funcionamento do cliente do configuration manager, válido apenas para dispositivos geridos pelo Agente MDM/ConfigMgr
configurationManagerClientInformation	configurationManagerClientInformation	Informações do cliente do configuration manager, válidas apenas para dispositivos geridos, geridos por duel ou trigeridos pelo Agente do ConfigMgr
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.
processorArchitecture	managedDeviceArchitecture	Arquitetura do processador. Essa propriedade é somente leitura. Os valores possíveis são: `unknown`, `x86`, `x64`, `arm`, `arM64`.
specificationVersion	Cadeia de caracteres	Versão de especificação. Essa propriedade é somente leitura.
joinType	joinType	Tipo de associação de dispositivo. Os valores possíveis são: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.
skuFamily	Cadeia de caracteres	Família de SKU do dispositivo
securityPatchLevel	Cadeia de caracteres	Isto indica o nível de patch de segurança do sistema operativo. Estas atualizações especiais contêm correções de segurança importantes. Para iOS/MacOS, estão no formato (a). Para android está no formato 2017-08-07. Essa propriedade é somente leitura.
skuNumber	Int32	Número de SKU do dispositivo, consulte também: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valores válidos de 0 a 2147483647. Essa propriedade é somente leitura.
managementFeatures	managedDeviceManagementFeatures	Funcionalidades de gestão de dispositivos. Os valores possíveis são: `none` e `microsoftManagedDesktop`.
chromeOSDeviceInfo	chromeOSDeviceProperty collection	Lista de propriedades do Dispositivo ChromeOS. A predefinição é uma lista 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.
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.
bootstrapTokenEscrowed	Booliano	Comunica se o dispositivo gerido tem um Token bootstrap com segurança. Isto destina-se apenas a dispositivos macOS. Para obter, inclua BootstrapTokenEscrowed na cláusula select e consulte com um ID de dispositivo. Se FOR FALSO, nenhum token de bootstrap é registado. Se FOR VERDADEIRO, o dispositivo criou um token bootstrap com o Intune. Essa propriedade é somente leitura.
deviceFirmwareConfigurationInterfaceManaged	Booliano	Indica se o dispositivo é gerido por DFCI. Quando VERDADEIRO, o dispositivo é gerido por DFCI. Quando falso, o dispositivo não é gerido pela DFCI. O valor padrão é FALSO.
deviceIdentityAttestationDetail	deviceIdentityAttestationDetail	Indica o estado do atestado do dispositivo gerido. E para que lado. Predefinição: Desconhecido.

Resposta

Se bem-sucedido, este método retornará um código de resposta 200 OK e um objeto managedDevice atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 9620

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "hardwareInformation": {
    "@odata.type": "microsoft.graph.hardwareInformation",
    "serialNumber": "Serial Number value",
    "totalStorageSpace": 1,
    "freeStorageSpace": 0,
    "imei": "Imei value",
    "meid": "Meid value",
    "manufacturer": "Manufacturer value",
    "model": "Model value",
    "phoneNumber": "Phone Number value",
    "subscriberCarrier": "Subscriber Carrier value",
    "cellularTechnology": "Cellular Technology value",
    "wifiMac": "Wifi Mac value",
    "operatingSystemLanguage": "Operating System Language value",
    "isSupervised": true,
    "isEncrypted": true,
    "batterySerialNumber": "Battery Serial Number value",
    "batteryHealthPercentage": 7,
    "batteryChargeCycles": 3,
    "isSharedDevice": true,
    "sharedDeviceCachedUsers": [
      {
        "@odata.type": "microsoft.graph.sharedAppleDeviceUser",
        "userPrincipalName": "User Principal Name value",
        "dataToSync": true,
        "dataQuota": 9,
        "dataUsed": 8
      }
    ],
    "tpmSpecificationVersion": "Tpm Specification Version value",
    "operatingSystemEdition": "Operating System Edition value",
    "deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
    "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
    "deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
    "deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
    "osBuildNumber": "Os Build Number value",
    "operatingSystemProductType": 10,
    "ipAddressV4": "Ip Address V4 value",
    "subnetAddress": "Subnet Address value",
    "esimIdentifier": "Esim Identifier value",
    "systemManagementBIOSVersion": "System Management BIOSVersion value",
    "tpmManufacturer": "Tpm Manufacturer value",
    "tpmVersion": "Tpm Version value",
    "wiredIPv4Addresses": [
      "Wired IPv4Addresses value"
    ],
    "batteryLevelPercentage": 7.333333333333333,
    "residentUsersCount": 2,
    "productName": "Product Name value",
    "deviceLicensingStatus": "licenseRefreshPending",
    "deviceLicensingLastErrorCode": 12,
    "deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
  },
  "ownerType": "company",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "managementState": "retirePending",
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "chassisType": "desktop",
  "operatingSystem": "Operating System value",
  "deviceType": "windowsRT",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "aadRegistered": true,
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "lostModeState": "enabled",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true,
    "endpointProtection": true,
    "officeApps": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value",
    "memoryIntegrityProtection": "enabled",
    "memoryAccessProtection": "enabled",
    "virtualizationBasedSecurity": "enabled",
    "firmwareProtection": "systemGuardSecureLaunch",
    "systemManagementMode": "level1",
    "securedCorePC": "enabled"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
  "usersLoggedOn": [
    {
      "@odata.type": "microsoft.graph.loggedOnUser",
      "userId": "User Id value",
      "lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
    }
  ],
  "preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
  "autopilotEnrolled": true,
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "windowsActiveMalwareCount": 9,
  "windowsRemediatedMalwareCount": 13,
  "notes": "Notes value",
  "configurationManagerClientHealthState": {
    "@odata.type": "microsoft.graph.configurationManagerClientHealthState",
    "state": "installed",
    "errorCode": 9,
    "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
  },
  "configurationManagerClientInformation": {
    "@odata.type": "microsoft.graph.configurationManagerClientInformation",
    "clientIdentifier": "Client Identifier value",
    "isBlocked": true,
    "clientVersion": "Client Version value"
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "securityPatchLevel": "Security Patch Level value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop",
  "chromeOSDeviceInfo": [
    {
      "@odata.type": "microsoft.graph.chromeOSDeviceProperty",
      "name": "Name value",
      "value": "Value value",
      "valueType": "Value Type value",
      "updatable": true
    }
  ],
  "enrollmentProfileName": "Enrollment Profile Name value",
  "bootstrapTokenEscrowed": true,
  "deviceFirmwareConfigurationInterfaceManaged": true,
  "deviceIdentityAttestationDetail": {
    "@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
    "deviceIdentityAttestationStatus": "trusted"
  }
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 9669

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "705c034c-034c-705c-4c03-5c704c035c70",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "hardwareInformation": {
    "@odata.type": "microsoft.graph.hardwareInformation",
    "serialNumber": "Serial Number value",
    "totalStorageSpace": 1,
    "freeStorageSpace": 0,
    "imei": "Imei value",
    "meid": "Meid value",
    "manufacturer": "Manufacturer value",
    "model": "Model value",
    "phoneNumber": "Phone Number value",
    "subscriberCarrier": "Subscriber Carrier value",
    "cellularTechnology": "Cellular Technology value",
    "wifiMac": "Wifi Mac value",
    "operatingSystemLanguage": "Operating System Language value",
    "isSupervised": true,
    "isEncrypted": true,
    "batterySerialNumber": "Battery Serial Number value",
    "batteryHealthPercentage": 7,
    "batteryChargeCycles": 3,
    "isSharedDevice": true,
    "sharedDeviceCachedUsers": [
      {
        "@odata.type": "microsoft.graph.sharedAppleDeviceUser",
        "userPrincipalName": "User Principal Name value",
        "dataToSync": true,
        "dataQuota": 9,
        "dataUsed": 8
      }
    ],
    "tpmSpecificationVersion": "Tpm Specification Version value",
    "operatingSystemEdition": "Operating System Edition value",
    "deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
    "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
    "deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
    "deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
    "osBuildNumber": "Os Build Number value",
    "operatingSystemProductType": 10,
    "ipAddressV4": "Ip Address V4 value",
    "subnetAddress": "Subnet Address value",
    "esimIdentifier": "Esim Identifier value",
    "systemManagementBIOSVersion": "System Management BIOSVersion value",
    "tpmManufacturer": "Tpm Manufacturer value",
    "tpmVersion": "Tpm Version value",
    "wiredIPv4Addresses": [
      "Wired IPv4Addresses value"
    ],
    "batteryLevelPercentage": 7.333333333333333,
    "residentUsersCount": 2,
    "productName": "Product Name value",
    "deviceLicensingStatus": "licenseRefreshPending",
    "deviceLicensingLastErrorCode": 12,
    "deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
  },
  "ownerType": "company",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "managementState": "retirePending",
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "chassisType": "desktop",
  "operatingSystem": "Operating System value",
  "deviceType": "windowsRT",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "aadRegistered": true,
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "lostModeState": "enabled",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true,
    "endpointProtection": true,
    "officeApps": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value",
    "memoryIntegrityProtection": "enabled",
    "memoryAccessProtection": "enabled",
    "virtualizationBasedSecurity": "enabled",
    "firmwareProtection": "systemGuardSecureLaunch",
    "systemManagementMode": "level1",
    "securedCorePC": "enabled"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
  "usersLoggedOn": [
    {
      "@odata.type": "microsoft.graph.loggedOnUser",
      "userId": "User Id value",
      "lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
    }
  ],
  "preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
  "autopilotEnrolled": true,
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "windowsActiveMalwareCount": 9,
  "windowsRemediatedMalwareCount": 13,
  "notes": "Notes value",
  "configurationManagerClientHealthState": {
    "@odata.type": "microsoft.graph.configurationManagerClientHealthState",
    "state": "installed",
    "errorCode": 9,
    "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
  },
  "configurationManagerClientInformation": {
    "@odata.type": "microsoft.graph.configurationManagerClientInformation",
    "clientIdentifier": "Client Identifier value",
    "isBlocked": true,
    "clientVersion": "Client Version value"
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "securityPatchLevel": "Security Patch Level value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop",
  "chromeOSDeviceInfo": [
    {
      "@odata.type": "microsoft.graph.chromeOSDeviceProperty",
      "name": "Name value",
      "value": "Value value",
      "valueType": "Value Type value",
      "updatable": true
    }
  ],
  "enrollmentProfileName": "Enrollment Profile Name value",
  "bootstrapTokenEscrowed": true,
  "deviceFirmwareConfigurationInterfaceManaged": true,
  "deviceIdentityAttestationDetail": {
    "@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
    "deviceIdentityAttestationStatus": "trusted"
  }
}

Compartilhar via

Atualizar managedDevice

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários

Recursos adicionais