Actualizar windows81GeneralConfiguration

Espacio de nombres: microsoft.graph

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

Actualice las propiedades de un objeto windows81GeneralConfiguration.

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) DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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, especifique una representación JSON del objeto windows81GeneralConfiguration.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto windows81GeneralConfiguration.

Propiedad Tipo Descripción
id Cadena Clave de la entidad. Heredado de deviceConfiguration
lastModifiedDateTime DateTimeOffset Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration
createdDateTime DateTimeOffset Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration
description Cadena Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
displayName Cadena Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
version Int32 Versión de la configuración del dispositivo. Heredado de deviceConfiguration
accountsBlockAddingNonMicrosoftAccountEmail Booleano Indica si se va a impedir que el usuario agregue cuentas de correo electrónico en el dispositivo que no están asociadas a una cuenta de Microsoft.
applyOnlyToWindows81 Booleano Valor que indica si esta directiva se aplica solo a Windows 8.1. Esta propiedad es de solo lectura.
browserBlockAutofill Booleano Indica si se va a bloquear el autorrelleno.
browserBlockAutomaticDetectionOfIntranetSites Booleano Indica si se va a bloquear la detección automática de sitios de intranet.
browserBlockEnterpriseModeAccess Booleano Indica si se va a bloquear el acceso al modo de empresa.
browserBlockJavaScript Booleano Indica si se va a impedir que el usuario utilice JavaScript.
browserBlockPlugins Booleano Indica si se van a bloquear los complementos.
browserBlockPopups Booleano Indica si se van a bloquear los elementos emergentes.
browserBlockSendingDoNotTrackHeader Booleano Indica si se va a impedir que el usuario envíe el encabezado Do Not Track.
browserBlockSingleWordEntryOnIntranetSites Booleano Indica si se va a bloquear la entrada de palabra única en sitios de intranet.
browserRequireSmartScreen Booleano Indica si se va a requerir que el usuario use el filtro de pantalla inteligente.
browserEnterpriseModeSiteListLocation Cadena Ubicación de la lista de sitios del modo de empresa. Puede ser un archivo local, la red local o la ubicación http.
browserInternetSecurityLevel internetSiteSecurityLevel Nivel de seguridad de Internet. Los valores posibles son: userDefined, medium, mediumHigh y high.
browserIntranetSecurityLevel siteSecurityLevel Nivel de seguridad de la intranet. Los valores posibles son: userDefined, low, mediumLow, medium, mediumHigh y high.
browserLoggingReportLocation Cadena Ubicación del informe de registro.
browserRequireHighSecurityForRestrictedSites Booleano Indica si se va a requerir alta seguridad para los sitios restringidos.
browserRequireFirewall Booleano Indica si se va a requerir un firewall.
browserRequireFraudWarning Booleano Indica si se va a requerir una advertencia de fraude.
browserTrustedSitesSecurityLevel siteSecurityLevel Nivel de seguridad de los sitios de confianza. Los valores posibles son: userDefined, low, mediumLow, medium, mediumHigh y high.
cellularBlockDataRoaming Booleano Indica si se va a bloquear la itinerancia de datos.
diagnosticsBlockDataSubmission Booleano Indica si se va a bloquear el envío de datos de diagnóstico.
passwordBlockPicturePasswordAndPin Booleano Indica si se va a impedir que el usuario utilice una contraseña de imágenes y un PIN.
passwordExpirationDays Int32 Expiración de la contraseña en días.
passwordMinimumLength Int32 Longitud mínima de la contraseña.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla.
passwordMinimumCharacterSetCount Int32 Número de juegos de caracteres necesarios en la contraseña.
passwordPreviousPasswordBlockCount Int32 Número de contraseñas anteriores que impide su reutilización. Valores válidos de 0 a 24.
passwordRequiredType requiredPasswordType Tipo de contraseña necesaria. Los valores posibles son: deviceDefault, alphanumeric y numeric.
passwordSignInFailureCountBeforeFactoryReset Int32 Número de errores de inicio de sesión permitidos antes del restablecimiento de fábrica.
storageRequireDeviceEncryption Booleano Indica si se va a requerir el cifrado en un dispositivo móvil.
updatesRequireAutomaticUpdates Booleano Indica si se van a requerir las actualizaciones automáticas.
userAccountControlSettings windowsUserAccountControlSettings Configuración de control de la cuenta de usuario. Los valores posibles son: userDefined, alwaysNotify, notifyOnAppChanges, notifyOnAppChangesWithoutDimming y neverNotify.
workFoldersUrl Cadena Dirección URL de las carpetas de trabajo.

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1693

{
  "@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountsBlockAddingNonMicrosoftAccountEmail": true,
  "applyOnlyToWindows81": true,
  "browserBlockAutofill": true,
  "browserBlockAutomaticDetectionOfIntranetSites": true,
  "browserBlockEnterpriseModeAccess": true,
  "browserBlockJavaScript": true,
  "browserBlockPlugins": true,
  "browserBlockPopups": true,
  "browserBlockSendingDoNotTrackHeader": true,
  "browserBlockSingleWordEntryOnIntranetSites": true,
  "browserRequireSmartScreen": true,
  "browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
  "browserInternetSecurityLevel": "medium",
  "browserIntranetSecurityLevel": "low",
  "browserLoggingReportLocation": "Browser Logging Report Location value",
  "browserRequireHighSecurityForRestrictedSites": true,
  "browserRequireFirewall": true,
  "browserRequireFraudWarning": true,
  "browserTrustedSitesSecurityLevel": "low",
  "cellularBlockDataRoaming": true,
  "diagnosticsBlockDataSubmission": true,
  "passwordBlockPicturePasswordAndPin": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordRequiredType": "alphanumeric",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "storageRequireDeviceEncryption": true,
  "updatesRequireAutomaticUpdates": true,
  "userAccountControlSettings": "alwaysNotify",
  "workFoldersUrl": "https://example.com/workFoldersUrl/"
}

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: 1865

{
  "@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
  "id": "0e9285b5-85b5-0e92-b585-920eb585920e",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountsBlockAddingNonMicrosoftAccountEmail": true,
  "applyOnlyToWindows81": true,
  "browserBlockAutofill": true,
  "browserBlockAutomaticDetectionOfIntranetSites": true,
  "browserBlockEnterpriseModeAccess": true,
  "browserBlockJavaScript": true,
  "browserBlockPlugins": true,
  "browserBlockPopups": true,
  "browserBlockSendingDoNotTrackHeader": true,
  "browserBlockSingleWordEntryOnIntranetSites": true,
  "browserRequireSmartScreen": true,
  "browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
  "browserInternetSecurityLevel": "medium",
  "browserIntranetSecurityLevel": "low",
  "browserLoggingReportLocation": "Browser Logging Report Location value",
  "browserRequireHighSecurityForRestrictedSites": true,
  "browserRequireFirewall": true,
  "browserRequireFraudWarning": true,
  "browserTrustedSitesSecurityLevel": "low",
  "cellularBlockDataRoaming": true,
  "diagnosticsBlockDataSubmission": true,
  "passwordBlockPicturePasswordAndPin": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordRequiredType": "alphanumeric",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "storageRequireDeviceEncryption": true,
  "updatesRequireAutomaticUpdates": true,
  "userAccountControlSettings": "alwaysNotify",
  "workFoldersUrl": "https://example.com/workFoldersUrl/"
}