Crear targetedManagedAppConfiguration

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 objeto targetedManagedAppConfiguration.

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 más a menos privilegiados)
Delegado (cuenta profesional o educativa)
Administración de aplicaciones móviles (MAM)	DeviceManagementApps.ReadWrite.All
Conjunto de directivas	DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación
Administración de aplicaciones móviles (MAM)	DeviceManagementApps.ReadWrite.All
Conjunto de directivas	DeviceManagementApps.ReadWrite.All

Solicitud HTTP

POST /deviceAppManagement/targetedManagedAppConfigurations

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, especifique una representación JSON del objeto targetedManagedAppConfiguration.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto targetedManagedAppConfiguration.

Propiedad	Tipo	Descripción
displayName	Cadena	Nombre para mostrar de la directiva. Heredado de managedAppPolicy.
description	Cadena	Descripción de la directiva. Heredado de managedAppPolicy.
createdDateTime	DateTimeOffset	Fecha y hora de creación de la directiva. Heredado de managedAppPolicy.
lastModifiedDateTime	DateTimeOffset	Última vez que se modificó la directiva. Heredado de managedAppPolicy.
roleScopeTagIds	Colección de cadenas	Lista de etiquetas de ámbito para esta instancia de entity. Heredado de managedAppPolicy.
id	Cadena	Clave de la entidad. Heredado de managedAppPolicy.
version	Cadena	Versión de la entidad. Heredado de managedAppPolicy.
customSettings	Colección keyValuePair	Un conjunto de pares de clave de cadena y valor de cadena que se va a enviar a las aplicaciones para aquellos usuarios que tienen limitada la configuración, sin modificar por este servicio. Heredado de managedAppConfiguration
deployedAppCount	Int32	Número de aplicaciones en las que se implementará la directiva actual.
isAssigned	Booleano	Indica si la directiva se implementará en los grupos de inclusión.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto targetedManagedAppConfiguration en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/deviceAppManagement/targetedManagedAppConfigurations
Content-type: application/json
Content-length: 450

{
  "@odata.type": "#microsoft.graph.targetedManagedAppConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "version": "Version value",
  "customSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "deployedAppCount": 0,
  "isAssigned": 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: 622

{
  "@odata.type": "#microsoft.graph.targetedManagedAppConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "id": "2444e029-e029-2444-29e0-442429e04424",
  "version": "Version value",
  "customSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "deployedAppCount": 0,
  "isAssigned": true
}