Créer des fenêtresAutopilotDeviceIdentity

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Créez un objet windowsAutopilotDeviceIdentity .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

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.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Requête HTTP

POST /deviceManagement/windowsAutopilotDeviceIdentities
POST /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile/assignedDevices

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet windowsAutopilotDeviceIdentity.

Le tableau suivant présente les propriétés requises lorsque vous créez windowsAutopilotDeviceIdentity.

Propriété	Type	Description
id	String	GUID de l’objet
deploymentProfileAssignmentStatus	windowsAutopilotProfileAssignmentStatus	Affectation de profil status de l’appareil Windows Autopilot. Les valeurs possibles sont les suivantes : unknown, assignedInSync, assignedOutOfSync, assignedUnkownSyncState, notAssigned, pending et failed.
deploymentProfileAssignmentDetailedStatus	windowsAutopilotProfileAssignmentDetailedStatus	Attribution de profil détaillée status de l’appareil Windows Autopilot. Les valeurs possibles sont les suivantes : none, hardwareRequirementsNotMet, surfaceHubProfileNotSupported, holoLensProfileNotSupported, windowsPcProfileNotSupported, surfaceHub2SProfileNotSupported et unknownFutureValue.
deploymentProfileAssignedDateTime	DateTimeOffset	Heure du jeu de profils de l’appareil Windows Autopilot.
groupTag	String	Étiquette de groupe de l’appareil Windows Autopilot.
purchaseOrderIdentifier	String	Identificateur de bon de commande de l’appareil Windows Autopilot.
serialNumber	String	Numéro de série de l’appareil Windows autopilot.
productKey	String	Clé de produit de l’appareil Windows autopilot.
Fabricant	String	Fabricant oem de l’appareil Windows Autopilot.
model	String	Nom du modèle de l’appareil Windows Autopilot.
enrollmentState	enrollmentState	Intune’état d’inscription de l’appareil Windows Autopilot. Les valeurs possibles sont unknown, enrolled, pendingReset, failed, notContacted, blocked.
lastContactedDateTime	DateTimeOffset	Intune date et heure du dernier contact de l’appareil Windows Autopilot.
addressableUserName	String	Nom d’utilisateur adressable.
userPrincipalName	String	Nom d’utilisateur principal.
resourceName	String	Nom de la ressource.
skuNumber	String	Numéro de référence SKU
systemFamily	String	Famille de systèmes
azureActiveDirectoryDeviceId	String	ID d’appareil AAD : à déprécier
azureAdDeviceId	String	ID d’appareil AAD
managedDeviceId	String	ID d’appareil géré
displayName	String	Nom d’affichage
deviceAccountUpn	String	Upn du compte d’appareil Surface Hub
deviceAccountPassword	String	Mot de passe du compte d’appareil Surface Hub
deviceFriendlyName	String	Nom convivial de l’appareil Surface Hub
remediationState	windowsAutopilotDeviceRemediationState	État de correction de l’appareil. Les valeurs possibles sont les suivantes : unknown, noRemediationRequired, automaticRemediationRequired, manualRemediationRequired, unknownFutureValue.
remediationStateLastModifiedDateTime	DateTimeOffset	RemediationState définit l’heure de l’appareil Autopilot.
userlessEnrollmentStatus	windowsAutopilotUserlessEnrollmentStatus	Inscription status pour les inscriptions sans utilisateur. Les valeurs possibles sont les suivantes : unknown, allowed, blocked, unknownFutureValue.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet windowsAutopilotDeviceIdentity dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}

Réponse

Voici un exemple de 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.

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

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "id": "fac6f0b1-f0b1-fac6-b1f0-c6fab1f0c6fa",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}