Créer windowsManagedDeviceCreate windowsManagedDevice

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important : Les API Microsoft Graph sous la version/beta peuvent faire l’objet de modifications ; l’utilisation de la production n’est pas prise en charge.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Crée un objet windowsManagedDevice .Create a new windowsManagedDevice object.

Conditions préalablesPrerequisites

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (par ordre décroissant du niveau de privilège)Permissions (from most to least privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All

Requête HTTPHTTP Request

POST /deviceManagement/managedDevices
POST /deviceManagement/comanagedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur <token> obligatoire.Bearer <token> Required.
AccepterAccept application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON de l’objet windowsManagedDevice.In the request body, supply a JSON representation for the windowsManagedDevice object.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez le windowsManagedDevice.The following table shows the properties that are required when you create the windowsManagedDevice.

PropriétéProperty TypeType DescriptionDescription
idid StringString Identificateur unique de l’appareil.Unique Identifier for the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
userIduserId StringString Identificateur unique de l’utilisateur associé à l’appareil.Unique Identifier for the user associated with the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
deviceNamedeviceName StringString Nom de l’appareil.Name of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
hardwareInformationhardwareInformation hardwareInformationhardwareInformation Détails de l’hardward de l’appareil.The hardward details for the device. Inclut des informations telles que l’espace de stockage, le fabricant, le numéro de série, etc. Cette propriété est en lecture seule.Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Hérité de managedDeviceInherited from managedDevice
ownerTypeownerType ownerTypeownerType Propriété de l’appareil.Ownership of the device. Peut être « Company » ou « Personal » hérité de managedDevice.Can be 'company' or 'personal' Inherited from managedDevice. Les valeurs possibles sont unknown, company et personal.Possible values are: unknown, company, personal.
managedDeviceOwnerTypemanagedDeviceOwnerType managedDeviceOwnerTypemanagedDeviceOwnerType Propriété de l’appareil.Ownership of the device. Peut être « Company » ou « Personal » hérité de managedDevice.Can be 'company' or 'personal' Inherited from managedDevice. Les valeurs possibles sont unknown, company et personal.Possible values are: unknown, company, personal.
deviceActionResultsdeviceActionResults Collection deviceActionResultdeviceActionResult collection Liste des objets deviceActionResult ComplexType.List of ComplexType deviceActionResult objects. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
managementStatemanagementState managementStatemanagementState État de gestion de l’appareil.Management state of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : managed, retirePending, retireFailed, wipePending, wipeFailed, unhealthy, deletePending, retireIssued, wipeIssued, wipeCanceled, retireCanceled et discovered.Possible values are: managed, retirePending, retireFailed, wipePending, wipeFailed, unhealthy, deletePending, retireIssued, wipeIssued, wipeCanceled, retireCanceled, discovered.
enrolledDateTimeenrolledDateTime DateTimeOffsetDateTimeOffset Heure d’inscription de l’appareil.Enrollment time of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset La date et l’heure de dernière synchronisation de l’appareil avec Intune.The date and time that the device last completed a successful sync with Intune. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
chassisTypechassisType chassisTypechassisType Type de châssis de l’appareil.Chassis type of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, desktop, laptop, worksWorkstation, enterpriseServer, phone, tablet, mobileOther, mobileUnknown.Possible values are: unknown, desktop, laptop, worksWorkstation, enterpriseServer, phone, tablet, mobileOther, mobileUnknown.
operatingSystemoperatingSystem StringString Système d’exploitation de l’appareil.Operating system of the device. Windows, iOS, etc. Cette propriété est en lecture seule.Windows, iOS, etc. This property is read-only. Hérité de managedDeviceInherited from managedDevice
deviceTypedeviceType deviceTypedeviceType Plateforme de l’appareil.Platform of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes :,,,,,,,,,,,,,,,,,,,,,,, et desktop windowsRT winMO6 nokia windowsPhone mac winCE winEmbedded iPhone iPad iPod android iSocConsumer unix macMDM holoLens surfaceHub androidForWork androidEnterprise windows10x androidnGMS cloudPC blackberry palm unknown .Possible values are: desktop, windowsRT, winMO6, nokia, windowsPhone, mac, winCE, winEmbedded, iPhone, iPad, iPod, android, iSocConsumer, unix, macMDM, holoLens, surfaceHub, androidForWork, androidEnterprise, windows10x, androidnGMS, cloudPC, blackberry, palm, unknown.
complianceStatecomplianceState complianceStatecomplianceState État de conformité de l’appareil.Compliance state of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, compliant, noncompliant, conflict, error, inGracePeriod et configManager.Possible values are: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBrokenjailBroken StringString Si l’appareil est débridé ou associé à une racine.whether the device is jail broken or rooted. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
managementAgentmanagementAgent managementAgentTypemanagementAgentType Canal de gestion de l’appareil.Management channel of the device. Intune, EAS, etc. Cette propriété est en lecture seule.Intune, EAS, etc. This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController, microsoft365ManagedMdm, windowsManagementCloudApi.Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController, microsoft365ManagedMdm, windowsManagementCloudApi.
osVersionosVersion StringString Version du système d’exploitation de l’appareil.Operating system version of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
easActivatedeasActivated BooléenBoolean Si Exchange ActiveSync est activé sur l’appareil.Whether the device is Exchange ActiveSync activated. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
easDeviceIdeasDeviceId StringString ID Exchange ActiveSync de l’appareil.Exchange ActiveSync Id of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
easActivationDateTimeeasActivationDateTime DateTimeOffsetDateTimeOffset Heure de l’activation d’Exchange ActivationSync de l’appareil.Exchange ActivationSync activation time of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
aadRegisteredaadRegistered BooléenBoolean Si l’appareil est inscrit auprès d’Azure Active Directory.Whether the device is Azure Active Directory registered. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
azureADRegisteredazureADRegistered BooléenBoolean Si l’appareil est inscrit auprès d’Azure Active Directory.Whether the device is Azure Active Directory registered. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
deviceEnrollmentTypedeviceEnrollmentType deviceEnrollmentTypedeviceEnrollmentType Type d’inscription de l’appareil.Enrollment type of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, appleUserEnrollment, appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, androidEnterpriseDedicatedDevice, androidEnterpriseFullyManaged et androidEnterpriseCorporateWorkProfile.Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, appleUserEnrollment, appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, androidEnterpriseDedicatedDevice, androidEnterpriseFullyManaged, androidEnterpriseCorporateWorkProfile.
lostModeStatelostModeState lostModeStatelostModeState Indique si le mode perdu est activé ou désactivé.Indicates if Lost mode is enabled or disabled. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : disabled, enabled.Possible values are: disabled, enabled.
activationLockBypassCodeactivationLockBypassCode StringString Code permettant le verrouillage d’activation sur un appareil à ignorer.Code that allows the Activation Lock on a device to be bypassed. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
emailAddressemailAddress StringString E-mail (s) pour l’utilisateur associé à l’appareil.Email(s) for the user associated with the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
Propriétés azureactivedirectorydeviceidazureActiveDirectoryDeviceId StringString Identificateur unique de l’appareil Azure Active Directory.The unique identifier for the Azure Active Directory device. En lecture seule.Read only. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
azureADDeviceIdazureADDeviceId StringString Identificateur unique de l’appareil Azure Active Directory.The unique identifier for the Azure Active Directory device. En lecture seule.Read only. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
deviceRegistrationStatedeviceRegistrationState deviceRegistrationStatedeviceRegistrationState État de l’inscription de l’appareilDevice registration state. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment et unknown.Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayNamedeviceCategoryDisplayName StringString Nom complet de la catégorie d’appareil.Device category display name. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
isSupervisedisSupervised BooléenBoolean État supervisé par l’appareil.Device supervised status. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
exchangeLastSuccessfulSyncDateTimeexchangeLastSuccessfulSyncDateTime DateTimeOffsetDateTimeOffset Dernière fois que l’appareil a contacté Exchange.Last time the device contacted Exchange. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
exchangeAccessStateexchangeAccessState deviceManagementExchangeAccessStatedeviceManagementExchangeAccessState État de l’accès de l’appareil dans Exchange.The Access State of the device in Exchange. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : none, unknown, allowed, blocked et quarantined.Possible values are: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReasonexchangeAccessStateReason deviceManagementExchangeAccessStateReasondeviceManagementExchangeAccessStateReason Motif lié à l’état de l’accès dans Exchange.The reason for the device's access state in Exchange. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword et deviceNotKnownWithManagedApp.Possible values are: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrlremoteAssistanceSessionUrl StringString URL permettant à une session d’assistance à distance d’être établie avec l’appareil.Url that allows a Remote Assistance session to be established with the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
remoteAssistanceSessionErrorDetailsremoteAssistanceSessionErrorDetails StringString Chaîne d’erreur identifiant les problèmes lors de la création d’objets de session d’assistance à distance.An error string that identifies issues when creating Remote Assistance session objects. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
isEncryptedisEncrypted BooléenBoolean État du chiffrement de l’appareil.Device encryption status. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
userPrincipalNameuserPrincipalName StringString Nom d’utilisateur principal de l’appareil.Device user principal name. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
modèlemodel StringString Modèle de l’appareil.Model of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
Fabricantmanufacturer StringString Fabricant de l’appareil.Manufacturer of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
imeiimei StringString IMEI.IMEI. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
complianceGracePeriodExpirationDateTimecomplianceGracePeriodExpirationDateTime DateTimeOffsetDateTimeOffset Date et heure d’expiration de la période de grâce de conformité de l’appareil.The DateTime when device compliance grace period expires. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
serialNumberserialNumber StringString Série.SerialNumber. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
phoneNumberphoneNumber StringString Numéro de téléphone de l’appareil.Phone number of the device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
androidSecurityPatchLevelandroidSecurityPatchLevel StringString Niveau de correctif de sécurité Android.Android security patch level. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
userDisplayNameuserDisplayName StringString Nom d’affichage de l’utilisateur.User display name. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures Fonctionnalités de client ConfigrMgr activées.ConfigrMgr client enabled features. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
wiFiMacAddresswiFiMacAddress StringString MAC Wi-Fi.Wi-Fi MAC. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
deviceHealthAttestationStatedeviceHealthAttestationState deviceHealthAttestationStatedeviceHealthAttestationState État de l’attestation d’intégrité de l’appareilThe device health attestation state. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
subscriberCarriersubscriberCarrier StringString Opérateur d’abonné.Subscriber Carrier. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
meidmeid StringString MEID.MEID. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
totalStorageSpaceInBytestotalStorageSpaceInBytes Int64Int64 Stockage total en octets.Total Storage in Bytes. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
freeStorageSpaceInBytesfreeStorageSpaceInBytes Int64Int64 Stockage libre en octets.Free Storage in Bytes. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
managedDeviceNamemanagedDeviceName StringString Nom généré automatiquement permettant d’identifier un appareil.Automatically generated name to identify a device. Peut être remplacé par un nom d’utilisateur convivial.Can be overwritten to a user friendly name. Hérité de managedDeviceInherited from managedDevice
partnerReportedThreatStatepartnerReportedThreatState managedDevicePartnerReportedHealthStatemanagedDevicePartnerReportedHealthState Indique l’état des menaces d’un appareil lorsqu’un partenaire Mobile Threat Defense est utilisé par le compte et l’appareil.Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. En lecture seule.Read Only. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised et misconfigured.Possible values are: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.
retireAfterDateTimeretireAfterDateTime DateTimeOffsetDateTimeOffset Indique le délai après lequel un appareil est retiré automatiquement en raison de l’action planifiée.Indicates the time after when a device will be auto retired because of scheduled action. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
usersLoggedOnusersLoggedOn collection loggedOnUserloggedOnUser collection Indique les derniers utilisateurs ayant ouvert une session sur un appareil.Indicates the last logged on users of a device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
preferMdmOverGroupPolicyAppliedDateTimepreferMdmOverGroupPolicyAppliedDateTime DateTimeOffsetDateTimeOffset Indique le DateTime que le paramètre preferMdmOverGroupPolicy a été défini.Reports the DateTime the preferMdmOverGroupPolicy setting was set. Lorsque ce paramètre est défini, les paramètres Intune MDM remplacent les paramètres de la stratégie de groupe en cas de conflit.When set, the Intune MDM settings will override Group Policy settings if there is a conflict. En lecture seule.Read Only. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
autopilotEnrolledautopilotEnrolled BooleanBoolean Signale si l’appareil géré est s’inscrire via le pilote automatique.Reports if the managed device is enrolled via auto-pilot. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
requireUserEnrollmentApprovalrequireUserEnrollmentApproval BooleanBoolean Signale si l’appareil iOS géré est l’enregistrement d’approbation de l’utilisateur.Reports if the managed iOS device is user approval enrollment. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
managementCertificateExpirationDatemanagementCertificateExpirationDate DateTimeOffsetDateTimeOffset Signale la date d’expiration du certificat de gestion des appareils.Reports device management certificate expiration date. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
iccidiccid StringString Identificateur de carte de circuit intégré, il s’agit d’un numéro d’identification unique de carte SIM.Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
udidudid StringString Identificateur de périphérique unique pour les appareils iOS et macOS.Unique Device Identifier for iOS and macOS devices. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
roleScopeTagIdsroleScopeTagIds Collection de chaînesString collection Liste des ID de balise d’étendue pour cette instance d’appareil.List of Scope Tag IDs for this Device instance. Hérité de managedDeviceInherited from managedDevice
windowsActiveMalwareCountwindowsActiveMalwareCount Int32Int32 Nombre de programmes malveillants actifs pour ce périphérique Windows.Count of active malware for this windows device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
windowsRemediatedMalwareCountwindowsRemediatedMalwareCount Int32Int32 Nombre de programmes malveillants corrigés pour ce périphérique Windows.Count of remediated malware for this windows device. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
notesnotes StringString Remarques sur l’appareil créé par l’administrateur informatique, hérité de managedDeviceNotes on the device created by IT Admin Inherited from managedDevice
configurationManagerClientHealthStateconfigurationManagerClientHealthState configurationManagerClientHealthStateconfigurationManagerClientHealthState État d’intégrité du client Configuration Manager, valide uniquement pour les appareils gérés par l’agent MDM/ConfigMgr hérité de managedDeviceConfiguration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from managedDevice
configurationManagerClientInformationconfigurationManagerClientInformation configurationManagerClientInformationconfigurationManagerClientInformation Informations sur le client Configuration Manager, valides uniquement pour les périphériques gérés par Duel gérée ou tri-géré par ConfigMgr agent hérité de managedDeviceConfiguration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from managedDevice
ethernetMacAddressethernetMacAddress StringString MAC Ethernet.Ethernet MAC. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
physicalMemoryInBytesphysicalMemoryInBytes Int64Int64 Mémoire totale en octets.Total Memory in Bytes. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
ArchitectureprocessorArchitecture managedDeviceArchitecturemanagedDeviceArchitecture Architecture de processeur.Processor architecture. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDevice.Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, x86, x64, arm, arM64.Possible values are: unknown, x86, x64, arm, arM64.
specificationVersionspecificationVersion StringString Version de spécification.Specification version. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
joinTypejoinType joinTypejoinType Type de jonction d’appareil hérité de managedDevice.Device join type Inherited from managedDevice. Les valeurs possibles sont les suivantes : unknown, azureADJoined, azureADRegistered, hybridAzureADJoined.Possible values are: unknown, azureADJoined, azureADRegistered, hybridAzureADJoined.
skuFamilyskuFamily StringString Famille de SKU de périphériques héritée de managedDeviceDevice sku family Inherited from managedDevice
skuNumberskuNumber Int32Int32 Numéro SKU de l’appareil, voir également : https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo .Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valeurs valides comprises entre 0 et 2147483647.Valid values 0 to 2147483647. Cette propriété est en lecture seule.This property is read-only. Hérité de managedDeviceInherited from managedDevice
managementFeaturesmanagementFeatures managedDeviceManagementFeaturesmanagedDeviceManagementFeatures Fonctionnalités de gestion des appareils héritées de managedDevice.Device management features Inherited from managedDevice. Les valeurs possibles sont les suivantes : none, microsoftManagedDesktop.Possible values are: none, microsoftManagedDesktop.

RéponseResponse

Si elle réussit, cette méthode renvoie un 201 Created Code de réponse et un objet windowsManagedDevice dans le corps de la réponse.If successful, this method returns a 201 Created response code and a windowsManagedDevice object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/managedDevices
Content-type: application/json
Content-length: 8026

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "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
  },
  "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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop"
}

RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 8075

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "id": "97842b67-2b67-9784-672b-8497672b8497",
  "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
  },
  "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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop"
}