Erstellen von windowsAppX
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues windowsAppX-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-Anforderung
POST /deviceAppManagement/mobileApps
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das windowsAppX-Objekt an.
Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen der windowsAppX erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Schlüssel der Entität Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
displayName | String | Der vom Administrator bereitgestellte oder importierte Titel der App. Geerbt von mobileApp. |
description | String | Beschreibung der App. Geerbt von mobileApp. |
publisher | String | Der Herausgeber der App. Geerbt von mobileApp. |
largeIcon | mimeContent | Das große Symbol, das in den App-Details angezeigt und für den Upload des Symbols verwendet werden soll. Geerbt von mobileApp. |
createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung der App. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der App. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
isFeatured | Boolean | Wert, der angibt, ob die App vom Administrator als empfohlen markiert wurde. Geerbt von mobileApp. |
privacyInformationUrl | String | URL zur Datenschutzerklärung Geerbt von mobileApp. |
informationUrl | String | URL zur Seite mit weiteren Informationen. Geerbt von mobileApp. |
owner | String | Der Besitzer der App. Geerbt von mobileApp. |
developer | String | Der Entwickler der App. Geerbt von mobileApp. |
notes | String | Hinweise für die App. Geerbt von mobileApp. |
uploadState | Int32 | Der Uploadstatus. Mögliche Werte sind: 0 - Not Ready , 1 - Ready , 2 - Processing . Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
publishingState | mobileAppPublishingState | Der Veröffentlichungsstatus für die App. Die App kann nicht zugewiesen werden, solange sie nicht veröffentlicht wurde. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. Mögliche Werte sind: notPublished , processing und published . |
isAssigned | Boolesch | Der Wert, der angibt, ob die App mindestens einer Gruppe zugewiesen ist. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
roleScopeTagIds | String collection | Liste der Bereichstag-IDs für diese mobile App. Geerbt von mobileApp. |
dependentAppCount | Int32 | Die Gesamtanzahl der Abhängigkeiten, über die die untergeordnete App verfügt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
supersedingAppCount | Int32 | Die Gesamtzahl der Apps, die diese App direkt oder indirekt ersetzt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
supersedededAppCount | Int32 | Die Gesamtzahl der Apps, von der diese App direkt oder indirekt abgelöst wird. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileApp. |
committedContentVersion | String | Die interne zugesicherte Inhaltsversion. Geerbt von mobileLobApp. |
fileName | String | Name der Hauptdatei der Branchenanwendung. Geerbt von mobileLobApp. |
size | Int64 | Gesamtgröße einschließlich aller hochgeladenen Dateien. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileLobApp. |
applicableArchitectures | windowsArchitecture | Die Windows-Architektur(en), auf der diese App ausgeführt werden kann. Mögliche Werte sind: none , x86 , x64 , arm , , neutral ; Standardwert ist none . Mögliche Werte sind: none , x86 , x64 , arm , neutral und arm64 . |
identityName | String | Der Identitätsname des hochgeladenen App-Pakets. Beispiel: "Contoso.DemoApp". |
identityPublisherHash | String | Der Identitätsherausgeberhash des hochgeladenen App-Pakets. Dies ist der Hash des Herausgebers aus dem Manifest. Beispiel: "AB82CD0XYZ". |
identityResourceIdentifier | String | Der Identitätsressourcenbezeichner des hochgeladenen App-Pakets. Beispiel: "TestResourceId". |
isBundle | Boolesch | Gibt bei TRUE an, dass die App ein Bündel ist. Gibt bei FALSE an, dass die App kein Bündel ist. Standardmäßig ist die Eigenschaft auf FALSE festgelegt. |
minimumSupportedOperatingSystem | windowsMinimumOperatingSystem | Der Wert für die Mindestversion des verwendbaren Betriebssystems. Gültige Werte für eine WindowsAppX-App sind v8_0 , v8_1 und v10_0 . Wenn es sich bei der App um ein Bündel handelt, muss das mindestens unterstützte Betriebssystem mindestens v8_1 sein. |
identityVersion | String | Die Identitätsversion des hochgeladenen App-Pakets. Beispiel: "1.0.0.0". |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created
Antwortcode und ein windowsAppX-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
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"
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für