Actualizar androidForWorkGeneralDeviceConfiguration

Artículo
08/01/2024

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

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}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{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 androidForWorkGeneralDeviceConfiguration .

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

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
roleScopeTagIds	Colección string	Lista de etiquetas de ámbito para esta instancia de entity. Heredado de deviceConfiguration
supportsScopeTags	Booleano	Indica si la configuración de dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite asignar a la propiedad ScopeTags cuando este valor es false y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre para las directivas heredadas creadas en Silverlight y se pueden resolver mediante la eliminación y la recreación de la directiva en Azure Portal. Esta propiedad es de sólo lectura. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Aplicabilidad de la edición del sistema operativo para esta directiva. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Regla de aplicabilidad de la versión del sistema operativo para esta directiva. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Regla de aplicabilidad del modo de dispositivo para esta directiva. 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
passwordBlockFaceUnlock	Booleano	Indica si se va a bloquear el desbloqueo facial.
passwordBlockFingerprintUnlock	Booleano	Indica si se va a impedir el desbloqueo por huella digital.
passwordBlockIrisUnlock	Booleano	Indica si se va a bloquear el desbloqueo del iris.
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	androidForWorkRequiredPasswordType	Tipo de contraseña que es necesario. Los valores posibles son: `deviceDefault`, `lowSecurityBiometric`, `required`, `atLeastNumeric`, `numericComplex`, `atLeastAlphabetic`, `atLeastAlphanumeric` y `alphanumericWithSymbols`.
requiredPasswordComplexity	androidRequiredPasswordComplexity	Indica la complejidad de la contraseña del dispositivo necesaria en Android. Uno de ellos: NONE, LOW, MEDIUM, HIGH. Se trata de una nueva API destinada a Android 12+. Los valores posibles son: `none`, `low`, `medium` y `high`.
workProfileDataSharingType	androidForWorkCrossProfileDataSharingType	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	androidForWorkDefaultAppPermissionPolicyType	Tipo de contraseña que es necesario. Los valores posibles son: `deviceDefault`, `prompt`, `autoGrant` y `autoDeny`.
workProfilePasswordBlockFaceUnlock	Booleano	Indica si se va a bloquear el desbloqueo facial para el perfil de trabajo.
workProfilePasswordBlockFingerprintUnlock	Booleano	Indica si se va a bloquear el desbloqueo de huellas digitales para el perfil de trabajo.
workProfilePasswordBlockIrisUnlock	Booleano	Indica si se va a bloquear el desbloqueo del iris 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	androidForWorkRequiredPasswordType	Tipo de contraseña de perfil de trabajo necesaria. Los valores posibles son: `deviceDefault`, `lowSecurityBiometric`, `required`, `atLeastNumeric`, `numericComplex`, `atLeastAlphabetic`, `atLeastAlphanumeric` y `alphanumericWithSymbols`.
workProfileRequiredPasswordComplexity	androidRequiredPasswordComplexity	Indica la complejidad necesaria de la contraseña del perfil de trabajo en Android. Uno de ellos: NONE, LOW, MEDIUM, HIGH. Se trata de una nueva API destinada a Android 12+. Los valores posibles son: `none`, `low`, `medium` y `high`.
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.
vpnAlwaysOnPackageIdentifier	Cadena	Habilite el modo de bloqueo para VPN siempre activa.
vpnEnableAlwaysOnLockdownMode	Booleano	Habilite el modo de bloqueo para VPN siempre activa.
workProfileAllowWidgets	Booleano	Permitir widgets de aplicaciones de perfil de trabajo.
workProfileBlockPersonalAppInstallsFromUnknownSources	Booleano	Impedir instalaciones de aplicaciones de orígenes desconocidos en el perfil personal.
workProfileAccountUse	androidWorkProfileAccountUse	Controlar la capacidad del usuario para agregar cuentas en el perfil de trabajo, incluidas las cuentas de Google. Los valores posibles son: `allowAllExceptGoogleAccounts`, `blockAll`, `allowAll` y `unknownFutureValue`.
allowedGoogleAccountDomains	Colección string	Determine la lista de permitidos de dominios para las cuentas que se pueden agregar al perfil de trabajo.
blockUnifiedPasswordForWorkProfile	Booleano	Evite el uso de una contraseña unificada para desbloquear el dispositivo y el perfil de trabajo.

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 3343

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "requiredPasswordComplexity": "low",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": 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",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": true,
  "workProfileAccountUse": "blockAll",
  "allowedGoogleAccountDomains": [
    "Allowed Google Account Domains value"
  ],
  "blockUnifiedPasswordForWorkProfile": 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: 3515

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "id": "a931a366-a366-a931-66a3-31a966a331a9",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "requiredPasswordComplexity": "low",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": 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",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": true,
  "workProfileAccountUse": "blockAll",
  "allowedGoogleAccountDomains": [
    "Allowed Google Account Domains value"
  ],
  "blockUnifiedPasswordForWorkProfile": true
}

Compartir a través de

Actualizar androidForWorkGeneralDeviceConfiguration

Permisos

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplo

Solicitud

Respuesta

Comentarios

Recursos adicionales