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
Importante: A Microsoft dá suporte a APIs /beta do Intune, mas elas estão sujeitas a alterações mais frequentes. A Microsoft recomenda usar a versão v1.0 sempre que possível. Verifique a disponibilidade de uma API na versão v1.0 usando o seletor de versão.
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.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA 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) | DeviceManagementManagedDevices.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Application | 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 usuário associado ao dispositivo. Essa propriedade é somente leitura. |
| deviceName | Cadeia de caracteres | Nome do dispositivo. Suporta $filter operador 'eq' e 'contains'. 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. Por padrão, a maioria das propriedades desse tipo é definida como null/0/false e padrões de enumeração para tipos associados. 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. |
| ownerType | ownerType | Propriedade do dispositivo. Os valores possíveis são, 'empresa' ou 'pessoal'. O padrão é desconhecido. Suporta $filter operador 'eq' e 'or'. 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. Exemplos: Gerenciado, RetirePendente etc. O padrão é gerenciado. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. Os valores possíveis são: managed, retirePending, retireFailed, wipePending, wipeFailed, unhealthy, deletePending, retireIssued, wipeIssued, wipeCanceled, retireCanceled, discovered e unknownFutureValue. |
| 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 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. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| deviceType | deviceType | Plataforma do dispositivo. Exemplos: Desktop, WindowsRT etc. O padrão é desconhecido. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. Os valores possíveis são: desktop, windowsRT, winMO6, nokiaunknownpalmblackberryvisionOStvOSlinuxandroidnGMSchromeOSwindows10xandroidForWorkandroidEnterprisesurfaceHubholoLensmacMDMunixiSocConsumerwindowsPhoneandroidiPodwinCEmacwinEmbeddediPhoneiPad. cloudPC |
| 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, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController, microsoft365ManagedMdm, msSense, intuneAosp, google, unknownFutureValue. |
| osVersion | String | A versão do sistema operacional do dispositivo. Suporta $filter operador 'contém'. 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, deviceEnrollmentManager, appleBulkWithUserwindowsAutoEnrollmentappleAccountDrivenUserEnrollmentandroidEnterpriseCorporateWorkProfile, androidEnterpriseFullyManagedunknownFutureValue, androidAOSPUserlessDeviceEnrollmentandroidAOSPUserOwnedDeviceEnrollmentandroidEnterpriseDedicatedDeviceazureAdJoinUsingAzureVmExtensionappleUserEnrollmentWithServiceAccountappleUserEnrollmentwindowsCoManagementwindowsBulkUserlesswindowsAzureADJoinUsingDeviceAuthappleBulkWithoutUserwindowsAzureADJoinwindowsBulkAzureDomainJoin, |
| 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 | 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. Suporta $filter operador 'contém'. 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. Dá suporte a $filter operador 'eq', não combina com count. 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 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. Suporta $filter operador 'eq' e 'or'. 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 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 Suporta $filter operador 'eq' e 'ne'. Essa propriedade é somente leitura. |
| enrolledByUserPrincipalName | Cadeia de caracteres | O Nome Principal do Usuário do Entra (Azure AD) (UPN) do usuário responsável pelo registro do dispositivo. Essa propriedade é somente leitura. |
| modelo | Cadeia de caracteres | Modelo do dispositivo. Suporta $filter operador 'eq' e 'contains'. Essa propriedade é somente leitura. |
| fabricante | Cadeia de caracteres | Fabricante do dispositivo. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| imei | Cadeia de caracteres | IMEI do dispositivo. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| complianceGracePeriodExpirationDateTime | DateTimeOffset | A data e hora em que o período de carência de conformidade do dispositivo expira. Suporta $filter operador 'lt' e 'gt'. Essa propriedade é somente leitura. |
| serialNumber | Cadeia de caracteres | Número de série do dispositivo. Suporta $filter operador 'eq' e 'or'. Essa propriedade é somente leitura. |
| phoneNumber | Cadeia de caracteres | Número de telefone do dispositivo. Suporta $filter operador 'contém'. 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. |
| retireAfterDateTime | DateTimeOffset | Indica o tempo após quando um dispositivo será desativado automaticamente devido a uma 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 que a configuração DateTime the preferMdmOverGroupPolicy foi definida. Quando definidas, as configurações de MDM do Intune substituirão as configurações da Política de Grupo se houver um conflito. Somente leitura. Essa propriedade é somente leitura. |
| autopilotEnrolled | Booliano | Relata se o dispositivo gerenciado está registrado por meio do piloto automático. Essa propriedade é somente leitura. |
| 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. |
| 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. 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. Essa propriedade é somente leitura. |
| windowsRemediatedMalwareCount | Int32 | Contagem de malware corrigido para este dispositivo Windows. 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. 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. |
| 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álido somente para dispositivos gerenciados, gerenciados por duelo ou gerenciados triplicadamente pelo agente ConfigMgr |
| 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. |
| 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 da 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 SKUs do dispositivo |
| securityPatchLevel | Cadeia de caracteres | Isso indica o nível do patch de segurança do sistema operacional. Essas atualizações especiais contêm correções de segurança importantes. Para iOS/MacOS, eles estão no formato (a). Para Android, está no formato 2017-08-07. Essa propriedade é somente leitura. |
| skuNumber | Int32 | Número 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 | Recursos de gerenciamento de dispositivos. Os valores possíveis são: none e microsoftManagedDesktop. |
| chromeOSDeviceInfo | Coleção chromeOSDeviceProperty | Lista de propriedades do dispositivo ChromeOS. O padrão é uma lista vazia. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída no parâmetro select. |
| supplementalDeviceDetails | coleção supplementalDeviceDetail | Lista de propriedades fornecidas pelo dispositivo para descrever seu próprio estado. Cada propriedade inclui um título, um valor e um tipo de valor. Essas propriedades serão específicas da plataforma e são preenchidas dinamicamente pelo dispositivo. O padrão é uma lista vazia. Para recuperar valores reais, a chamada GET precisa ser feita, com a ID do dispositivo e incluída como um parâmetro $SELECT. 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. |
| bootstrapTokenEscrowed | Booliano | Relata se o dispositivo gerenciado tem um Token de Inicialização caucionado. Isso é apenas para dispositivos macOS. Para obter, inclua BootstrapTokenEscrowed na cláusula select e consulte com uma ID de dispositivo. Se for FALSE, nenhum token de inicialização será caucionado. Se for TRUE, o dispositivo caucionou um token de inicialização com o Intune. Essa propriedade é somente leitura. |
| deviceFirmwareConfigurationInterfaceManaged | Booliano | Indica se o dispositivo é gerenciado por DFCI. Quando TRUE, o dispositivo é gerenciado por DFCI. Quando FALSE, o dispositivo não é gerenciado por DFCI. O valor padrão é FALSO. |
| deviceIdentityAttestationDetail | deviceIdentityAttestationDetail | Indica o status de atestado do dispositivo gerenciado. E de que forma. Padrã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: 9954
{
"@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",
"enrolledByUserPrincipalName": "Enrolled By 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
}
],
"supplementalDeviceDetails": [
{
"@odata.type": "microsoft.graph.supplementalDeviceDetail",
"propertyName": "Property Name value",
"propertyValue": "Property Value value",
"propertyType": "Property Type value"
}
],
"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: 10003
{
"@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",
"enrolledByUserPrincipalName": "Enrolled By 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
}
],
"supplementalDeviceDetails": [
{
"@odata.type": "microsoft.graph.supplementalDeviceDetail",
"propertyName": "Property Name value",
"propertyValue": "Property Value value",
"propertyType": "Property Type value"
}
],
"enrollmentProfileName": "Enrollment Profile Name value",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}