Crear androidForWorkCompliancePolicy

Espacio de nombres: microsoft.graph

Importante: Microsoft admite las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versión.

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

Cree un nuevo objeto androidForWorkCompliancePolicy .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado 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

POST /deviceManagement/deviceCompliancePolicies

Encabezados de solicitud

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

Cuerpo de la solicitud

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

En la tabla siguiente se muestran las propiedades necesarias para crear la androidForWorkCompliancePolicy.

Propiedad Tipo Descripción
roleScopeTagIds Colección string Lista de etiquetas de ámbito para esta instancia de entidad. Heredado de deviceCompliancePolicy.
id Cadena Clave de la entidad. Heredado de deviceCompliancePolicy.
createdDateTime DateTimeOffset Fecha y hora en la que se creó el objeto. Heredado de deviceCompliancePolicy.
description Cadena Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceCompliancePolicy.
lastModifiedDateTime DateTimeOffset Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceCompliancePolicy.
displayName Cadena Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceCompliancePolicy.
version Int32 Versión de la configuración del dispositivo. Heredado de deviceCompliancePolicy.
passwordRequired Booleano Exigir una contraseña para desbloquear el dispositivo.
passwordMinimumLength Int32 Longitud mínima de la contraseña. Valores válidos de 4 a 16
passwordRequiredType androidRequiredPasswordType Tipo de caracteres en la contraseña. Los valores posibles son: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex y any.
requiredPasswordComplexity androidRequiredPasswordComplexity Indica la complejidad requerida de la contraseña del dispositivo en Android. Uno de: NINGUNO, BAJO, MEDIO, ALTO. Esta es una nueva API dirigida a Android API 12+. Los valores posibles son: none, low, medium y high.
passwordMinutesOfInactivityBeforeLock Int32 Minutos de inactividad antes de que sea necesaria una contraseña.
passwordExpirationDays Int32 Número de días antes de que expire la contraseña. Valores válidos de 1 a 365
passwordPreviousPasswordBlockCount Int32 Número de contraseñas anteriores que bloquear. Valores válidos de 1 a 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Número de errores de inicio de sesión permitidos antes del restablecimiento de fábrica. Valores válidos del 1 al 16
workProfilePasswordExpirationInDays 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
workProfileInactiveBeforeScreenLockInMinutes Int32 Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla.
workProfilePreviousPasswordBlockCount Int32 Número de contraseñas de perfil de trabajo anterior que se van a bloquear. Valores válidos de 0 a 24.
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 requerida de la contraseña de perfil de trabajo en Android. Uno de: NINGUNO, BAJO, MEDIO, ALTO. Se trata de una nueva API dirigida 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
securityPreventInstallAppsFromUnknownSources Booleano Exigir que los dispositivos impidan la instalación de aplicaciones de orígenes desconocidos.
securityDisableUsbDebugging Booleano Deshabilitar la depuración USB en dispositivos Android.
securityRequireVerifyApps Booleano Requerir que la característica Verificar aplicaciones de Android esté activada.
deviceThreatProtectionEnabled Booleano Exigir que los dispositivos hayan habilitado la protección contra amenazas de dispositivo.
deviceThreatProtectionRequiredSecurityLevel deviceThreatProtectionLevel Exigir que el nivel de riesgo mínimo de Mobile Threat Protection informe del no cumplimiento. Los valores posibles son: unavailable, secured, low, medium, high y notSet.
securityBlockJailbrokenDevices Booleano Indica que el dispositivo no debe estar rooteado. Cuando es TRUE, si el dispositivo se detecta como rooteado, se notificará como no compatible. Cuando es FALSE, el dispositivo no se notifica como no compatible, independientemente del estado rooteado del dispositivo. El valor predeterminado es FALSE.
osMinimumVersion Cadena Versión mínima de Android.
osMaximumVersion Cadena Versión máxima de Android.
minAndroidSecurityPatchLevel Cadena Nivel de revisión de seguridad mínimo de Android.
storageRequireEncryption Booleano Exigir cifrado en dispositivos Android.
securityRequireSafetyNetAttestationBasicIntegrity Booleano Requerir que el dispositivo pase la comprobación de integridad de reproducción básica.
securityRequireSafetyNetAttestationCertifiedDevice Booleano Requerir que el dispositivo pase la comprobación de integridad de reproducción de integridad del dispositivo.
securityRequireGooglePlayServices Booleano Exigir que Google Play Services esté instalado y habilitado en el dispositivo.
securityRequireUpToDateSecurityProviders Booleano Exigir que el dispositivo tenga los proveedores de seguridad actualizados. El dispositivo requerirá que Google Play Services esté instalado y habilitado.
securityRequireCompanyPortalAppIntegrity Booleano Exigir que el dispositivo supere la comprobación de integridad en tiempo de ejecución de la aplicación cliente del Portal de empresa.
securityRequiredAndroidSafetyNetEvaluationType androidSafetyNetEvaluationType Requerir un tipo de evaluación de SafetyNet específico para el cumplimiento. Los valores posibles son basic y hardwareBacked.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto androidForWorkCompliancePolicy en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
Content-type: application/json
Content-length: 1735

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "requiredPasswordComplexity": "low",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "workProfilePasswordExpirationInDays": 3,
  "workProfilePasswordMinimumLength": 0,
  "workProfileInactiveBeforeScreenLockInMinutes": 12,
  "workProfilePreviousPasswordBlockCount": 5,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}

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 201 Created
Content-Type: application/json
Content-Length: 1907

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "id": "a8d667bd-67bd-a8d6-bd67-d6a8bd67d6a8",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "requiredPasswordComplexity": "low",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "workProfilePasswordExpirationInDays": 3,
  "workProfilePasswordMinimumLength": 0,
  "workProfileInactiveBeforeScreenLockInMinutes": 12,
  "workProfilePreviousPasswordBlockCount": 5,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}
  • Se actualizó por última vez el