Créer windowsAppX
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Créez un objet windowsAppX .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Requête HTTP
POST /deviceAppManagement/mobileApps
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet windowsAppX.
Le tableau suivant présente les propriétés requises lorsque vous créez l’objet windowsAppX.
| Propriété | Type | Description |
|---|---|---|
| id | String | Clé de l’entité. Cette propriété est en lecture seule. Hérité de mobileApp. |
| displayName | String | Titre de l’application, importé ou fourni par l’administrateur. Hérité de mobileApp. |
| description | String | Description de l’application. Hérité de mobileApp. |
| éditeur | String | Éditeur de l’application. Hérité de mobileApp. |
| largeIcon | mimeContent | Grande icône, à afficher dans les détails de l’application et permettant de télécharger l’icône. Hérité de mobileApp. |
| createdDateTime | DateTimeOffset | Date et heure de création de l’application. Cette propriété est en lecture seule. Hérité de mobileApp. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification de l’application. Cette propriété est en lecture seule. Hérité de mobileApp. |
| isFeaturedisFeatured | Booléen | Valeur indiquant si l’application est marquée comme recommandée par l’administrateur- Hérité de mobileApp. |
| privacyInformationUrl | String | URL de déclaration de confidentialité. Hérité de mobileApp. |
| informationUrl | String | URL pour plus d’informations. Hérité de mobileApp. |
| owner | String | Propriétaire de l’application. Hérité de mobileApp. |
| developer | String | Développeur de l’application. Hérité de mobileApp. |
| notes | String | Notes de l’application. Hérité de mobileApp. |
| uploadState | Int32 | État de chargement. Les valeurs possibles sont : 0 - Not Ready, 1 - Ready, 2 - Processing. Cette propriété est en lecture seule. Hérité de mobileApp. |
| publishingState | mobileAppPublishingState | État de publication pour l’application. L’application ne peut pas être affectée, sauf si elle est publiée. Cette propriété est en lecture seule. Hérité de mobileApp. Les valeurs possibles sont notPublished, processing et published. |
| isAssigned | Valeur booléenne | Valeur indiquant si l’application est affectée à au moins un groupe. Cette propriété est en lecture seule. Hérité de mobileApp. |
| roleScopeTagIds | String collection | Liste des ID de balise d’étendue pour cette application mobile. Hérité de mobileApp. |
| dependentAppCount | Int32 | Nombre total de dépendances de l’application enfant. Cette propriété est en lecture seule. Hérité de mobileApp. |
| supersedingAppCount | Int32 | Nombre total d’applications que cette application remplace directement ou indirectement. Cette propriété est en lecture seule. Hérité de mobileApp. |
| supersededAppCount | Int32 | Nombre total d’applications par laquelle cette application est remplacée directement ou indirectement. Cette propriété est en lecture seule. Hérité de mobileApp. |
| committedContentVersion | String | Version de contenu validé interne. Hérité de mobileLobApp. |
| fileName | String | Nom du fichier d’application métier principal. Hérité de mobileLobApp. |
| size | Int64 | Taille totale, tous les fichiers chargés compris. Cette propriété est en lecture seule. Hérité de mobileLobApp. |
| applicableArchitectures | windowsArchitecture | La ou les architectures Windows sur lesquelles cette application peut s’exécuter. Les valeurs possibles sont , none, x64x86, arm, neutral; la valeur par défaut est none. Les valeurs possibles sont none, x86, x64, arm, neutral, arm64. |
| identityName | Chaîne | Nom d’identité du package d’application chargé. Par exemple : « Contoso.DemoApp ». |
| identityPublisherHash | Chaîne | Hachage de l’éditeur d’identité du package d’application chargé. Il s’agit du hachage de l’éditeur à partir du manifeste. Par exemple : « AB82CD0XYZ ». |
| identityResourceIdentifier | Chaîne | Identificateur de ressource d’identité du package d’application chargé. Par exemple : « TestResourceId ». |
| isBundle | Valeur booléenne | Si la valeur est TRUE, indique que l’application est une offre groupée. Si la valeur est FALSE, indique que l’application n’est pas une offre groupée. Par défaut, la propriété a la valeur FALSE. |
| minimumSupportedOperatingSystem | windowsMinimumOperatingSystem | Valeur pour la version minimale du système d’exploitation applicable. Les valeurs valides pour une application WindowsAppX sont v8_0, v8_1 et v10_0. Si l’application est une offre groupée, le système d’exploitation minimum pris en charge doit être au moins v8_1. |
| identityVersion | Chaîne | Version d’identité du package d’application chargé. Par exemple : « 1.0.0.0 ». |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet windowsAppX dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1562
{
"@odata.type": "#microsoft.graph.windowsAppX",
"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,
"applicableArchitectures": "x86",
"identityName": "Identity Name value",
"identityPublisherHash": "Identity Publisher Hash value",
"identityResourceIdentifier": "Identity Resource Identifier value",
"isBundle": true,
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
"v8_0": true,
"v8_1": true,
"v10_0": true,
"v10_1607": true,
"v10_1703": true,
"v10_1709": true,
"v10_1803": true,
"v10_1809": true,
"v10_1903": true,
"v10_1909": true,
"v10_2004": true,
"v10_2H20": true,
"v10_21H1": true
},
"identityVersion": "Identity Version value"
}
Réponse
Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1734
{
"@odata.type": "#microsoft.graph.windowsAppX",
"id": "b5179a93-9a93-b517-939a-17b5939a17b5",
"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,
"applicableArchitectures": "x86",
"identityName": "Identity Name value",
"identityPublisherHash": "Identity Publisher Hash value",
"identityResourceIdentifier": "Identity Resource Identifier value",
"isBundle": true,
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
"v8_0": true,
"v8_1": true,
"v10_0": true,
"v10_1607": true,
"v10_1703": true,
"v10_1709": true,
"v10_1803": true,
"v10_1809": true,
"v10_1903": true,
"v10_1909": true,
"v10_2004": true,
"v10_2H20": true,
"v10_21H1": true
},
"identityVersion": "Identity Version value"
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour