Creación de androidForWorkGeneralDeviceConfiguration
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.
Cree un nuevo 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
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
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 201 Created código de respuesta y un objeto androidForWorkGeneralDeviceConfiguration en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
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 201 Created
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
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de