Creación de macOSLobApp
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 macOSLobApp .
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, DeviceManagementApps.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Solicitud HTTP
POST /deviceAppManagement/mobileApps
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 macOSLobApp.
En la tabla siguiente se muestran las propiedades necesarias al crear macOSLobApp.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| displayName | Cadena | Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp. |
| description | Cadena | Descripción de la aplicación. Heredado de mobileApp. |
| publicador | Cadena | Publicador de la aplicación. Heredado de mobileApp. |
| largeIcon | mimeContent | Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp. |
| createdDateTime | DateTimeOffset | Fecha y hora de creación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora de la última modificación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| isFeatured | Booleano | Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp. |
| privacyInformationUrl | Cadena | Dirección URL de la declaración de privacidad. Heredado de mobileApp. |
| informationUrl | Cadena | Dirección URL para obtener más información. Heredado de mobileApp. |
| owner | Cadena | Propietario de la aplicación. Heredado de mobileApp. |
| developer | Cadena | Desarrollador de la aplicación. Heredado de mobileApp. |
| notas | Cadena | Notas de la aplicación. Heredado de mobileApp. |
| uploadState | Int32 | Estado de carga. Los valores posibles son: 0 - Not Ready, 1 - Ready, 2 - Processing. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| publishingState | mobileAppPublishingState | Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Esta propiedad es de sólo lectura. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published. |
| isAssigned | Booleano | Valor que indica si la aplicación está asignada a al menos un grupo. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| roleScopeTagIds | Colección string | Lista de identificadores de etiqueta de ámbito para esta aplicación móvil. Heredado de mobileApp. |
| dependentAppCount | Int32 | Número total de dependencias que tiene la aplicación secundaria. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersedingAppCount | Int32 | El número total de aplicaciones que esta aplicación reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersededAppCount | Int32 | El número total de aplicaciones por las que esta aplicación se reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| committedContentVersion | Cadena | Versión interna del contenido confirmado. Heredado de mobileLobApp. |
| fileName | Cadena | Nombre del archivo de la aplicación de LOB principal. Heredado de mobileLobApp. |
| size | Int64 | Tamaño total, incluidos todos los archivos cargados. Esta propiedad es de sólo lectura. Heredado de mobileLobApp. |
| bundleId | Cadena | El bundleId principal del paquete. |
| minimumSupportedOperatingSystem | macOSMinimumOperatingSystem | ComplexType macOSMinimumOperatingSystem que indica el sistema operativo mínimo aplicable a la aplicación. |
| buildNumber | Cadena | Número de compilación del paquete. Esto debe coincidir con el paquete CFBundleShortVersionString del archivo .pkg. |
| versionNumber | Cadena | Número de versión del paquete. Esto debe coincidir con el paquete CFBundleVersion en el archivo packageinfo. |
| childApps | colección macOSLobChildApp | Lista de objetos ComplexType macOSLobChildApp. Representa las aplicaciones que se espera que instale el paquete. |
| md5HashChunkSize | Int32 | Tamaño del fragmento del hash MD5. Es "0" o está vacío si el paquete se cargó directamente. Si el Intune App Wrapping Tool se usa para crear un .intunemac, este valor se puede encontrar dentro del archivo Detection.xml. |
| md5Hash | Colección de cadenas | Códigos hash MD5. Esto está vacío si el paquete se cargó directamente. Si el Intune App Wrapping Tool se usa para crear un .intunemac, este valor se puede encontrar dentro del archivo Detection.xml. |
| ignoreVersionDetection | Booleano | Cuando es TRUE, indica que la versión de la aplicación NO se usará para detectar si la aplicación está instalada en un dispositivo. Cuando es FALSE, indica que la versión de la aplicación se usará para detectar si la aplicación está instalada en un dispositivo. Establézcalo en true para las aplicaciones que usan una característica de actualización automática. El valor predeterminado es FALSE. |
| installAsManaged | Booleano | Cuando es TRUE, indica que la aplicación se instalará como administrada (requiere macOS 11.0 y otras restricciones de paquetes administrados). Cuando es FALSE, indica que la aplicación se instalará como no administrada. El valor predeterminado es FALSE. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto macOSLobApp en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1734
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": 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: 1906
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"id": "7be9250a-250a-7be9-0a25-e97b0a25e97b",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": 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