Actualizar deviceEnrollmentPlatformRestrictionConfiguration
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 deviceEnrollmentPlatformRestrictionConfiguration .
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) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
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 deviceEnrollmentPlatformRestrictionConfiguration .
En la tabla siguiente se muestran las propiedades necesarias al crear deviceEnrollmentPlatformRestrictionConfiguration.
Propiedad | Tipo | Descripción |
---|---|---|
id | Cadena | Identificador único de la cuenta heredada de deviceEnrollmentConfiguration |
displayName | Cadena | Nombre para mostrar de la configuración de inscripción de dispositivos Heredado de deviceEnrollmentConfiguration |
description | Cadena | Descripción de la configuración de inscripción de dispositivos heredada de deviceEnrollmentConfiguration |
prioridad | Int32 | La prioridad se usa cuando un usuario existe en varios grupos a los que se asigna la configuración de inscripción. Los usuarios solo están sujetos a la configuración con el valor de prioridad más bajo. Heredado de deviceEnrollmentConfiguration |
createdDateTime | DateTimeOffset | Fecha y hora de creación en UTC de la configuración de inscripción de dispositivos Heredada de deviceEnrollmentConfiguration |
lastModifiedDateTime | DateTimeOffset | Fecha y hora de la última modificación en UTC de la configuración de inscripción de dispositivos Heredada de deviceEnrollmentConfiguration |
version | Int32 | La versión de la configuración de inscripción de dispositivos heredada de deviceEnrollmentConfiguration |
roleScopeTagIds | Colección string | Etiquetas de ámbito de rol opcionales para las restricciones de inscripción. Heredado de deviceEnrollmentConfiguration |
deviceEnrollmentConfigurationType | deviceEnrollmentConfigurationType | Compatibilidad con el tipo de configuración de inscripción Heredado de deviceEnrollmentConfiguration. Valores posibles: unknown , limit , platformRestrictions , windowsHelloForBusiness , defaultLimit , defaultPlatformRestrictions , defaultWindowsHelloForBusiness , defaultWindows10EnrollmentCompletionPageConfiguration , windows10EnrollmentCompletionPageConfiguration , deviceComanagementAuthorityConfiguration , singlePlatformRestriction , unknownFutureValue , enrollmentNotificationsConfiguration . |
platformRestriction | deviceEnrollmentPlatformRestriction | Restricciones basadas en la plataforma, la versión del sistema operativo de la plataforma y la propiedad del dispositivo |
platformType | enrollmentRestrictionPlatformType | Tipo de plataforma para la que se aplica esta restricción. Los valores posibles son: allPlatforms , ios , windows , windowsPhone , android , androidForWork , mac , linux y unknownFutureValue . |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto deviceEnrollmentPlatformRestrictionConfiguration actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
Content-type: application/json
Content-length: 765
{
"@odata.type": "#microsoft.graph.deviceEnrollmentPlatformRestrictionConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"platformRestriction": {
"@odata.type": "microsoft.graph.deviceEnrollmentPlatformRestriction",
"platformBlocked": true,
"personalDeviceEnrollmentBlocked": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"blockedManufacturers": [
"Blocked Manufacturers value"
],
"blockedSkus": [
"Blocked Skus value"
]
},
"platformType": "ios"
}
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: 937
{
"@odata.type": "#microsoft.graph.deviceEnrollmentPlatformRestrictionConfiguration",
"id": "dedce9f4-e9f4-dedc-f4e9-dcdef4e9dcde",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"platformRestriction": {
"@odata.type": "microsoft.graph.deviceEnrollmentPlatformRestriction",
"platformBlocked": true,
"personalDeviceEnrollmentBlocked": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"blockedManufacturers": [
"Blocked Manufacturers value"
],
"blockedSkus": [
"Blocked Skus value"
]
},
"platformType": "ios"
}
Comentarios
https://aka.ms/ContentUserFeedback.
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:Enviar y ver comentarios de