Mettre à jour windows10EnrollmentCompletionPageConfiguration
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 windows10EnrollmentCompletionPageConfiguration .
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/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
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 windows10EnrollmentCompletionPageConfiguration .
Le tableau suivant indique les propriétés requises lorsque vous créez windows10EnrollmentCompletionPageConfiguration.
| Propriété | Type | Description |
|---|---|---|
| id | String | Identificateur unique du compte Hérité de deviceEnrollmentConfiguration |
| displayName | String | Nom complet de la configuration d’inscription d’appareil Héritée de deviceEnrollmentConfiguration |
| description | String | Description de la configuration d’inscription d’appareil Héritée de deviceEnrollmentConfiguration |
| priorité | Int32 | La priorité est utilisée lorsqu’un utilisateur existe dans plusieurs groupes auxquels la configuration d’inscription est affectée. Les utilisateurs sont soumis uniquement à la configuration avec la valeur de priorité la plus faible. Hérité de deviceEnrollmentConfiguration |
| createdDateTime | DateTimeOffset | Date et heure de création au format UTC de la configuration d’inscription d’appareil Héritée de deviceEnrollmentConfiguration |
| lastModifiedDateTime | DateTimeOffset | Date et heure utc de la dernière modification de la configuration d’inscription d’appareil Héritée de deviceEnrollmentConfiguration |
| version | Int32 | Version de la configuration d’inscription d’appareil Héritée de deviceEnrollmentConfiguration |
| roleScopeTagIds | String collection | Balises d’étendue de rôle facultatives pour les restrictions d’inscription. Hérité de deviceEnrollmentConfiguration |
| deviceEnrollmentConfigurationType | deviceEnrollmentConfigurationType | Prise en charge du type de configuration d’inscription hérité de deviceEnrollmentConfiguration. Les valeurs possibles sont unknown, limit, platformRestrictions, windowsHelloForBusiness, defaultLimit, defaultPlatformRestrictions, defaultWindowsHelloForBusiness, defaultWindows10EnrollmentCompletionPageConfiguration, windows10EnrollmentCompletionPageConfiguration, deviceComanagementAuthorityConfiguration, singlePlatformRestriction, unknownFutureValue, enrollmentNotificationsConfiguration. |
| showInstallationProgress | Boolean | Lorsque la valeur est TRUE, affiche la progression de l’installation à l’utilisateur. Si la valeur est false, masque la progression de l’installation. La valeur par défaut est false. |
| blockDeviceSetupRetryByUser | Boolean | Lorsque la valeur est TRUE, empêche l’utilisateur de réessayer l’installation en cas d’échec de l’installation. Si la valeur est false, l’utilisateur est autorisé à réessayer. La valeur par défaut est false. |
| allowDeviceResetOnInstallFailure | Boolean | Lorsque la valeur est TRUE, autorise la réinitialisation de l’appareil en cas d’échec de l’installation. Lorsque la valeur est false, la réinitialisation est bloquée. La valeur par défaut est false. |
| allowLogCollectionOnInstallFailure | Boolean | Lorsque la valeur est TRUE, autorise la collecte des journaux en cas d’échec de l’installation. Si la valeur est false, la collecte de journaux n’est pas autorisée. La valeur par défaut est false. |
| customErrorMessage | String | Message d’erreur personnalisé à afficher en cas d’échec de l’installation. La longueur maximale est de 10 000. Exemple : « Impossible de terminer le programme d’installation. Veuillez réessayer ou contacter la personne chargée du support technique pour obtenir de l’aide. » |
| installProgressTimeoutInMinutes | Int32 | Délai d’expiration de la progression de l’installation en minutes. La valeur par défaut est de 60 minutes. |
| allowDeviceUseOnInstallFailure | Boolean | Lorsque la valeur est TRUE, permet à l’utilisateur de continuer à utiliser l’appareil en cas d’échec de l’installation. Si la valeur est false, bloque l’utilisateur en cas d’échec de l’installation. La valeur par défaut est false. |
| selectedMobileAppIds | String collection | Applications sélectionnées pour suivre l’status d’installation. Il se présente sous la forme d’un tableau de GUID. |
| allowNonBlockingAppInstallation | Boolean | Lorsque la valeur est TRUE, ESP (page d’état d’inscription) installe toutes les applications requises ciblées pendant la phase de technicien et ignore les échecs pour les applications non bloquantes. Lorsque la valeur est FALSE, ESP échoue en cas d’erreur lors de l’installation de l’application. La valeur par défaut est false. |
| installQualityUpdates | Boolean | Autorise l’installation des mises à jour de qualité pendant OOBE |
| trackInstallProgressForAutopilotOnly | Boolean | Si la valeur est TRUE, la progression de l’installation est suivie uniquement pour les scénarios d’inscription Autopilot. Si la valeur est false, d’autres scénarios sont également suivis. La valeur par défaut est false. |
| disableUserStatusTrackingAfterFirstUser | Boolean | Lorsque la valeur est TRUE, désactive l’affichage de la progression de l’installation pour le premier utilisateur après l’inscription. Si la valeur est false, active l’affichage de la progression. La valeur par défaut est false. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet windows10EnrollmentCompletionPageConfiguration mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
Content-type: application/json
Content-length: 873
{
"@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"showInstallationProgress": true,
"blockDeviceSetupRetryByUser": true,
"allowDeviceResetOnInstallFailure": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true,
"selectedMobileAppIds": [
"Selected Mobile App Ids value"
],
"allowNonBlockingAppInstallation": true,
"installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true,
"disableUserStatusTrackingAfterFirstUser": true
}
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: 1045
{
"@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
"id": "77bf8248-8248-77bf-4882-bf774882bf77",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"showInstallationProgress": true,
"blockDeviceSetupRetryByUser": true,
"allowDeviceResetOnInstallFailure": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true,
"selectedMobileAppIds": [
"Selected Mobile App Ids value"
],
"allowNonBlockingAppInstallation": true,
"installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true,
"disableUserStatusTrackingAfterFirstUser": true
}