windowsUniversalAppX erstellen
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 eines neuen windowsUniversalAppX-Objekts.
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 des windowsUniversalAppX-Objekts an.
In der folgenden Tabelle sind die Eigenschaften dargestellt, die zum Erstellen der windowsUniversalAppX 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-Architekturen, für die 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. |
| applicableDeviceTypes | windowsDeviceType | Die Windows-Gerätetypen, für die diese App ausgeführt werden kann. Mögliche Werte sind: none, desktop, mobile, holographic, , team; Standardwert ist none. Mögliche Werte sind: none, desktop, mobile, holographic, team und unknownFutureValue. |
| identityName | String | Der Identitätsname der App, der aus der appx-Datei analysiert wird, wenn sie über die Intune MEM-Konsole hochgeladen wird. Beispiel: "Contoso.DemoApp". |
| identityPublisherHash | String | Der Identitätsherausgeberhash der App, der aus der appx-Datei analysiert wird, wenn sie über die Intune MEM-Konsole hochgeladen wird. Beispiel: "AB82CD0XYZ". |
| identityResourceIdentifier | String | Der Identitätsressourcenbezeichner der App, der aus der appx-Datei analysiert wird, wenn sie über die Intune MEM-Konsole hochgeladen wird. Beispiel: "TestResourceId". |
| isBundle | Boolean | Gibt an, ob die App ein Bundle ist. Bei TRUE handelt es sich bei der App um ein Bündel. Wenn FALSE, ist die App kein Bündel. |
| minimumSupportedOperatingSystem | windowsMinimumOperatingSystem | Der Wert für das mindestens anwendbare Windows-Betriebssystem. |
| identityVersion | String | Die Identitätsversion der App, die aus der appx-Datei analysiert wird, wenn sie über die Intune MEM-Konsole hochgeladen wird. Beispiel: "1.0.0.0". |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created und ein Objekt des Typs windowsUniversalAppX 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: 1610
{
"@odata.type": "#microsoft.graph.windowsUniversalAppX",
"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",
"applicableDeviceTypes": "desktop",
"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: 1782
{
"@odata.type": "#microsoft.graph.windowsUniversalAppX",
"id": "4bc47eba-7eba-4bc4-ba7e-c44bba7ec44b",
"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",
"applicableDeviceTypes": "desktop",
"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
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für