Crear deviceManagementConfigurationPolicyCreate deviceManagementConfigurationPolicy
Espacio de nombres: microsoft.graphNamespace: 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.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Cree un nuevo objeto deviceManagementConfigurationPolicy .Create a new deviceManagementConfigurationPolicy object.
Requisitos previosPrerequisites
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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Tipo de permisoPermission type | Permisos (de más a menos privilegiados)Permissions (from most to least privileged) |
---|---|
Delegado (cuenta profesional o educativa)Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All |
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) | No admitida.Not supported. |
AplicaciónApplication | DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTPHTTP Request
POST /deviceManagement/configurationPolicies
Encabezados de solicitudRequest headers
EncabezadoHeader | ValorValue |
---|---|
AuthorizationAuthorization | Se requiere <token> de portador.Bearer <token> Required. |
AceptarAccept | application/jsonapplication/json |
Cuerpo de la solicitudRequest body
En el cuerpo de la solicitud, especifique una representación JSON del objeto deviceManagementConfigurationPolicy.In the request body, supply a JSON representation for the deviceManagementConfigurationPolicy object.
En la tabla siguiente se muestran las propiedades necesarias para crear el deviceManagementConfigurationPolicy.The following table shows the properties that are required when you create the deviceManagementConfigurationPolicy.
PropiedadProperty | TipoType | DescripciónDescription |
---|---|---|
idid | StringString | Clave del documento de directiva.Key of the policy document. Generado automáticamente.Automatically generated. |
namename | StringString | Nombre de directivaPolicy name |
descriptiondescription | StringString | Descripción de la DirectivaPolicy description |
Selectplatforms | deviceManagementConfigurationPlatformsdeviceManagementConfigurationPlatforms | Plataformas para esta Directiva.Platforms for this policy. Los valores posibles son: none , macOS , windows10X y windows10 .Possible values are: none , macOS , windows10X , windows10 . |
tecnologíastechnologies | deviceManagementConfigurationTechnologiesdeviceManagementConfigurationTechnologies | Tecnologías para esta Directiva.Technologies for this policy. Los valores posibles son: none , mdm , windows10XManagement y configManager .Possible values are: none , mdm , windows10XManagement , configManager . |
createdDateTimecreatedDateTime | DateTimeOffsetDateTimeOffset | Fecha y hora de creación de la Directiva.Policy creation date and time. Esta propiedad es de sólo lectura.This property is read-only. |
lastModifiedDateTimelastModifiedDateTime | DateTimeOffsetDateTimeOffset | Fecha y hora de la última modificación de la Directiva.Policy last modification date and time. Esta propiedad es de sólo lectura.This property is read-only. |
settingCountsettingCount | Int32Int32 | Número de opciones de configuración.Number of settings. Esta propiedad es de sólo lectura.This property is read-only. |
creationSourcecreationSource | StringString | Origen de creación de DirectivaPolicy creation source |
roleScopeTagIdsroleScopeTagIds | Colección stringString collection | Lista de etiquetas de ámbito para esta instancia de entidad.List of Scope Tags for this Entity instance. |
isAssignedisAssigned | BooleanoBoolean | Estado de asignación de directivas.Policy assignment status. Esta propiedad es de sólo lectura.This property is read-only. |
RespuestaResponse
Si se ejecuta correctamente, este método devuelve un 201 Created
código de respuesta y un objeto deviceManagementConfigurationPolicy en el cuerpo de la respuesta.If successful, this method returns a 201 Created
response code and a deviceManagementConfigurationPolicy object in the response body.
EjemploExample
SolicitudRequest
Aquí tiene un ejemplo de la solicitud.Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-type: application/json
Content-length: 346
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
"name": "Name value",
"description": "Description value",
"platforms": "macOS",
"technologies": "mdm",
"settingCount": 12,
"creationSource": "Creation Source value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"isAssigned": true
}
RespuestaResponse
Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 518
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
"id": "3ffd7cd0-7cd0-3ffd-d07c-fd3fd07cfd3f",
"name": "Name value",
"description": "Description value",
"platforms": "macOS",
"technologies": "mdm",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"settingCount": 12,
"creationSource": "Creation Source value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"isAssigned": true
}