Actualizar windows10EnrollmentCompletionPageConfiguration

  • Artículo

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto windows10EnrollmentCompletionPageConfiguration .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windows10EnrollmentCompletionPageConfiguration .

En la tabla siguiente se muestran las propiedades necesarias al crear windows10EnrollmentCompletionPageConfiguration.

Propiedad Tipo Descripción
id Cadena Identificador único de la cuenta heredada de deviceEnrollmentConfiguration
displayName Cadena Nombre para mostrar de la configuración de inscripción de dispositivos Heredado de deviceEnrollmentConfiguration
description Cadena Descripción de la configuración de inscripción de dispositivos heredada de deviceEnrollmentConfiguration
prioridad Int32 La prioridad se usa cuando un usuario existe en varios grupos a los que se asigna la configuración de inscripción. Los usuarios solo están sujetos a la configuración con el valor de prioridad más bajo. Heredado de deviceEnrollmentConfiguration
createdDateTime DateTimeOffset Fecha y hora de creación en UTC de la configuración de inscripción de dispositivos Heredada de deviceEnrollmentConfiguration
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación en UTC de la configuración de inscripción de dispositivos Heredada de deviceEnrollmentConfiguration
version Int32 La versión de la configuración de inscripción de dispositivos heredada de deviceEnrollmentConfiguration
roleScopeTagIds Colección de cadenas Etiquetas de ámbito de rol opcionales para las restricciones de inscripción. Heredado de deviceEnrollmentConfiguration
deviceEnrollmentConfigurationType deviceEnrollmentConfigurationType Compatibilidad con el tipo de configuración de inscripción Heredado de deviceEnrollmentConfiguration. Valores posibles: unknown, limit, platformRestrictions, windowsHelloForBusiness, defaultLimit, defaultPlatformRestrictions, defaultWindowsHelloForBusiness, defaultWindows10EnrollmentCompletionPageConfiguration, windows10EnrollmentCompletionPageConfiguration, deviceComanagementAuthorityConfiguration, singlePlatformRestriction, unknownFutureValue, enrollmentNotificationsConfiguration.
showInstallationProgress Booleano Cuando es TRUE, muestra el progreso de la instalación al usuario. Cuando es false, oculta el progreso de la instalación. El valor predeterminado es falso.
blockDeviceSetupRetryByUser Booleano Cuando es TRUE, impide que el usuario vuelva a intentar la instalación al producirse un error de instalación. Cuando es false, el usuario puede volver a intentarlo. El valor predeterminado es falso.
allowDeviceResetOnInstallFailure Booleano Cuando es TRUE, permite restablecer el dispositivo cuando se produce un error de instalación. Cuando es false, se bloquea el restablecimiento. El valor predeterminado es falso.
allowLogCollectionOnInstallFailure Booleano Cuando es TRUE, permite la recopilación de registros en caso de error de instalación. Cuando es false, no se permite la recopilación de registros. El valor predeterminado es falso.
customErrorMessage Cadena Mensaje de error personalizado que se mostrará tras un error de instalación. La longitud máxima es 10000. ejemplo: "No se pudo completar el programa de instalación. Vuelva a intentarlo o póngase en contacto con el soporte técnico para obtener ayuda".
installProgressTimeoutInMinutes Int32 Tiempo de espera del progreso de la instalación en minutos. El valor predeterminado es 60 minutos.
allowDeviceUseOnInstallFailure Booleano Cuando es TRUE, permite al usuario seguir usando el dispositivo en caso de error de instalación. Cuando es false, bloquea al usuario en caso de error de instalación. El valor predeterminado es falso.
selectedMobileAppIds Colección string Aplicaciones seleccionadas para realizar un seguimiento del estado de instalación. Se encuentra en forma de una matriz de GUID.
allowNonBlockingAppInstallation Booleano Cuando es TRUE, ESP (página estado de inscripción) instala todas las aplicaciones necesarias destinadas durante la fase del técnico y omite los errores de las aplicaciones que no están bloqueadas. Cuando es FALSE, se produce un error en ESP durante la instalación de la aplicación. El valor predeterminado es falso.
installQualityUpdates Booleano Permite la instalación de actualizaciones de calidad durante OOBE
trackInstallProgressForAutopilotOnly Booleano Cuando es TRUE, solo se realiza un seguimiento del progreso de la instalación en escenarios de inscripción de Autopilot. Cuando es false, también se realiza un seguimiento de otros escenarios. El valor predeterminado es falso.
disableUserStatusTrackingAfterFirstUser Booleano Cuando es TRUE, deshabilita la visualización del progreso de la instalación para la primera inscripción posterior al usuario. Cuando es false, permite mostrar el progreso. El valor predeterminado es falso.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto windows10EnrollmentCompletionPageConfiguration actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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
}