Mettre à jour azureADWindowsAutopilotDeploymentProfile
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.
Mettez à jour les propriétés d’un objet azureADWindowsAutopilotDeploymentProfile .
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
PATCH /deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId}
PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile
PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/intendedDeploymentProfile
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 azureADWindowsAutopilotDeploymentProfile .
Le tableau suivant indique les propriétés requises lorsque vous créez le fichier azureADWindowsAutopilotDeploymentProfile.
| Propriété | Type | Description |
|---|---|---|
| id | String | Clé de profil héritée de windowsAutopilotDeploymentProfile |
| displayName | String | Nom complet du profil de déploiement. La longueur maximale autorisée est de 200 caractères. Renvoyé par défaut. Prend en charge : $select, $top, $skip, $orderby. $Search et $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| description | String | Description du profil de déploiement. La longueur maximale autorisée est de 1 500 caractères. Prend en charge : $select, $top, $skip, $orderBy. $Search et $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| language | String | Code de langue à utiliser lors de la configuration de l’appareil. Par exemple, en-US. La valeur par défaut est os-default. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. En lecture seule. À partir de mai 2024, cette propriété ne sera plus prise en charge et sera marquée comme déconseillée. Utilisez les paramètres régionaux à la place. Hérité de windowsAutopilotDeploymentProfile |
| local | String | Paramètres régionaux (langue) à utiliser lors de la configuration de l’appareil. Par exemple, en-US. La valeur par défaut est os-default. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| createdDateTime | DateTimeOffset | Date et heure de création du profil de déploiement. La valeur ne peut pas être modifiée et est automatiquement renseignée lors de la création du profil. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. En lecture seule. Hérité de windowsAutopilotDeploymentProfile |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification du profil de déploiement. La valeur ne peut pas être mise à jour manuellement et est automatiquement renseignée lorsque des modifications sont apportées au profil. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge en lecture seule. Hérité de windowsAutopilotDeploymentProfile |
| outOfBoxExperienceSettings | outOfBoxExperienceSettings | Paramètres de profil Windows Autopilot Deployment utilisés par l’appareil Autopilot pour une expérience prête à l’emploi. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. En lecture seule. À partir de mai 2024, cette propriété ne sera plus prise en charge et sera marquée comme déconseillée. Utilisez outOfBoxExperienceSetting à la place. Hérité de windowsAutopilotDeploymentProfile |
| outOfBoxExperienceSetting | outOfBoxExperienceSetting | Paramètres de profil Windows Autopilot Deployment utilisés par l’appareil pour l’expérience prête à l’emploi. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| enrollmentStatusScreenSettings | windowsEnrollmentStatusScreenSettings | Paramètre d’écran d’status d’inscription Hérité de windowsAutopilotDeploymentProfile |
| extractHardwareHash | Boolean | Indique si le profil prend en charge l’extraction des valeurs de hachage matériel et l’inscription de l’appareil dans Windows Autopilot. Si la valeur est TRUE, indique si l’extraction matérielle et l’inscription Windows Autopilot se produisent lors de la prochaine case activée réussie. Lorsque la valeur est FALSE, l’extraction de hachage matériel et l’inscription Windows Autopilot ne se produisent pas. La valeur par défaut est FALSE. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. En lecture seule. À partir de mai 2024, cette propriété ne sera plus prise en charge et sera marquée comme déconseillée. Utilisez hardwareHashExtractionEnabled à la place. Hérité de windowsAutopilotDeploymentProfile |
| hardwareHashExtractionEnabled | Boolean | Indique si le profil prend en charge l’extraction des valeurs de hachage matériel et l’inscription de l’appareil dans Windows Autopilot. Si la valeur est TRUE, indique si l’extraction matérielle et l’inscription Windows Autopilot se produisent lors de la prochaine case activée réussie. Lorsque la valeur est FALSE, l’extraction de hachage matériel et l’inscription Windows Autopilot ne se produisent pas. La valeur par défaut est FALSE. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| deviceNameTemplate | String | Modèle utilisé pour nommer l’appareil Autopilot. Il peut s’agir d’un texte personnalisé qui peut également contenir le numéro de série de l’appareil ou un nombre généré de manière aléatoire. La longueur totale du texte généré par le modèle ne peut pas être supérieure à 15 caractères. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
| deviceType | windowsAutopilotDeviceType | Type d’appareil Windows auquel ce profil s’applique. Les valeurs possibles incluent windowsPc, holoLens et virtualMachine. La valeur par défaut est windowsPc. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile. Les valeurs possibles sont windowsPc, holoLens, surfaceHub2, surfaceHub2S, virtualMachine, unknownFutureValue. |
| enableWhiteGlove | Boolean | Indique si l’utilisateur est autorisé à utiliser Windows Autopilot pour le mode de déploiement préprovisionné pendant l’expérience OOBE (Out of Box Experience). Si la valeur est TRUE, indique que Windows Autopilot pour le mode de déploiement préprovisionné est autorisé. Si la valeur est false, Windows Autopilot pour le mode de déploiement préprovisionné n’est pas autorisé. Par défaut, la valeur est FALSE. En lecture seule. À partir de mai 2024, cette propriété ne sera plus prise en charge et sera marquée comme déconseillée. Utilisez preprovisioningAllowed à la place. Hérité de windowsAutopilotDeploymentProfile |
| preprovisioningAllowed | Boolean | Indique si l’utilisateur est autorisé à utiliser Windows Autopilot pour le mode de déploiement préprovisionné pendant l’expérience OOBE (Out of Box Experience). Si la valeur est TRUE, indique que Windows Autopilot pour le mode de déploiement préprovisionné pour OOBE est autorisé à être utilisé. Si la valeur est false, Windows Autopilot pour le mode de déploiement préprovisionné pour OOBE n’est pas autorisé. Par défaut, la valeur est FALSE. Hérité de windowsAutopilotDeploymentProfile |
| roleScopeTagIds | String collection | Liste des balises d’étendue de rôle pour le profil de déploiement. Hérité de windowsAutopilotDeploymentProfile |
| managementServiceAppId | String | ID d’application du service de gestion Entra qui est utilisé lors de la découverte de l’inscription basée sur l’appareil client. Prend en charge : $select, $top, $skip. $Search, les $orderBy et les $filter ne sont pas pris en charge. Hérité de windowsAutopilotDeploymentProfile |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet azureADWindowsAutopilotDeploymentProfile mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId}
Content-type: application/json
Content-length: 1628
{
"@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
"displayName": "Display Name value",
"description": "Description value",
"language": "Language value",
"locale": "Locale value",
"outOfBoxExperienceSettings": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
"hidePrivacySettings": true,
"hideEULA": true,
"userType": "standard",
"deviceUsageType": "shared",
"skipKeyboardSelectionPage": true,
"hideEscapeLink": true
},
"outOfBoxExperienceSetting": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
"privacySettingsHidden": true,
"eulaHidden": true,
"userType": "standard",
"deviceUsageType": "shared",
"keyboardSelectionPageSkipped": true,
"escapeLinkHidden": true
},
"enrollmentStatusScreenSettings": {
"@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
"hideInstallationProgress": true,
"allowDeviceUseBeforeProfileAndAppInstallComplete": true,
"blockDeviceSetupRetryByUser": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true
},
"extractHardwareHash": true,
"hardwareHashExtractionEnabled": true,
"deviceNameTemplate": "Device Name Template value",
"deviceType": "holoLens",
"enableWhiteGlove": true,
"preprovisioningAllowed": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"managementServiceAppId": "Management Service App Id value"
}
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 200 OK
Content-Type: application/json
Content-Length: 1800
{
"@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
"id": "e2ec4e69-4e69-e2ec-694e-ece2694eece2",
"displayName": "Display Name value",
"description": "Description value",
"language": "Language value",
"locale": "Locale value",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"outOfBoxExperienceSettings": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
"hidePrivacySettings": true,
"hideEULA": true,
"userType": "standard",
"deviceUsageType": "shared",
"skipKeyboardSelectionPage": true,
"hideEscapeLink": true
},
"outOfBoxExperienceSetting": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
"privacySettingsHidden": true,
"eulaHidden": true,
"userType": "standard",
"deviceUsageType": "shared",
"keyboardSelectionPageSkipped": true,
"escapeLinkHidden": true
},
"enrollmentStatusScreenSettings": {
"@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
"hideInstallationProgress": true,
"allowDeviceUseBeforeProfileAndAppInstallComplete": true,
"blockDeviceSetupRetryByUser": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true
},
"extractHardwareHash": true,
"hardwareHashExtractionEnabled": true,
"deviceNameTemplate": "Device Name Template value",
"deviceType": "holoLens",
"enableWhiteGlove": true,
"preprovisioningAllowed": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"managementServiceAppId": "Management Service App Id value"
}