Compartir a través de


Actualizar androidWorkProfileGeneralDeviceConfiguration

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 androidWorkProfileGeneralDeviceConfiguration .

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, proporcione una representación JSON para el objeto androidWorkProfileGeneralDeviceConfiguration .

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

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
passwordBlockFingerprintUnlock Booleano Indica si se va a impedir el desbloqueo por huella digital.
passwordBlockTrustAgents Booleano Indica si se van a bloquear Smart Lock y otros agentes de confianza.
passwordExpirationDays Int32 Número de días antes de que expire la contraseña. Valores válidos de 1 a 365.
passwordMinimumLength Int32 Longitud mínima de las contraseñas. Valores válidos de 4 a 16
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla.
passwordPreviousPasswordBlockCount Int32 Número de contraseñas anteriores que bloquear. Valores válidos de 0 a 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Número de errores de inicio de sesión permitidos antes del restablecimiento de fábrica. Valores válidos de 1 a 16
passwordRequiredType androidWorkProfileRequiredPasswordType Tipo de contraseña que es necesario. Los valores posibles son: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric y alphanumericWithSymbols.
workProfileDataSharingType androidWorkProfileCrossProfileDataSharingType Tipo de uso compartido de datos permitido. Los valores posibles son: deviceDefault, preventAny, allowPersonalToWork y noRestrictions.
workProfileBlockNotificationsWhileDeviceLocked Booleano Indica si se bloquean o no las notificaciones mientras el dispositivo está bloqueado.
workProfileBlockAddingAccounts Booleano Impedir que los usuarios agreguen o quiten cuentas en el perfil de trabajo.
workProfileBluetoothEnableContactSharing Booleano Permitir que los dispositivos Bluetooth accedan a los contactos empresariales.
workProfileBlockScreenCapture Booleano Bloquear captura de pantalla en el perfil de trabajo.
workProfileBlockCrossProfileCallerId Booleano Bloquear la visualización del identificador de llamada del perfil de trabajo en el perfil personal.
workProfileBlockCamera Booleano Bloquear cámara de perfil de trabajo.
workProfileBlockCrossProfileContactsSearch Booleano Bloquear la disponibilidad de contactos de perfil de trabajo en el perfil personal.
workProfileBlockCrossProfileCopyPaste Booleano Boolean que indica si la configuración no permite copiar y pegar entre perfiles está habilitada.
workProfileDefaultAppPermissionPolicy androidWorkProfileDefaultAppPermissionPolicyType Tipo de contraseña que es necesario. Los valores posibles son: deviceDefault, prompt, autoGrant y autoDeny.
workProfilePasswordBlockFingerprintUnlock Booleano Indica si se va a bloquear el desbloqueo de huellas digitales para el perfil de trabajo.
workProfilePasswordBlockTrustAgents Booleano Indica si se va a bloquear Smart Lock y otros agentes de confianza para el perfil de trabajo.
workProfilePasswordExpirationDays Int32 Número de días antes de que expire la contraseña del perfil de trabajo. Valores válidos de 1 a 365.
workProfilePasswordMinimumLength Int32 Longitud mínima de la contraseña del perfil de trabajo. Valores válidos de 4 a 16
workProfilePasswordMinNumericCharacters Int32 Número mínimo de caracteres numéricos necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinNonLetterCharacters Int32 Número mínimo de caracteres que no son letras necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinLetterCharacters Int32 Número mínimo de caracteres de letra necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinLowerCaseCharacters Int32 Número mínimo de caracteres en minúsculas necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinUpperCaseCharacters Int32 Número mínimo de caracteres en mayúsculas necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinSymbolCharacters Int32 Número mínimo de símbolos necesarios en la contraseña del perfil de trabajo. Valores válidos de 1 a 10
workProfilePasswordMinutesOfInactivityBeforeScreenTimeout Int32 Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla.
workProfilePasswordPreviousPasswordBlockCount Int32 Número de contraseñas de perfil de trabajo anteriores que se van a bloquear. Valores válidos de 0 a 24.
workProfilePasswordSignInFailureCountBeforeFactoryReset Int32 Número de errores de inicio de sesión permitidos antes de quitar el perfil de trabajo y eliminar todos los datos corporativos. Valores válidos de 1 a 16
workProfilePasswordRequiredType androidWorkProfileRequiredPasswordType Tipo de contraseña de perfil de trabajo necesaria. Los valores posibles son: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric y alphanumericWithSymbols.
workProfileRequirePassword Booleano La contraseña es necesaria o no para el perfil de trabajo
securityRequireVerifyApps Booleano Requerir que la característica Verificar aplicaciones de Android esté activada.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto androidWorkProfileGeneralDeviceConfiguration 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: 1831

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": 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: 2003

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "id": "6decda7e-da7e-6dec-7eda-ec6d7edaec6d",
  "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,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true
}