Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un nuevo 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
POST /deviceManagement/deviceConfigurations
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, , atLeastNumericrequired, numericComplex, atLeastAlphabetic, , atLeastAlphanumeric. 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, , atLeastNumericrequired, numericComplex, atLeastAlphabetic, , atLeastAlphanumeric. 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 201 Created código de respuesta y un objeto androidWorkProfileGeneralDeviceConfiguration en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
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 201 Created
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
}