MacOSLobApp 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 Sie ein neues macOSLobApp-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 macOSLobApp-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der macOSLobApp 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. |
| bundleId | String | Die primäre bundleId des Pakets. |
| minimumSupportedOperatingSystem | macOSMinimumOperatingSystem | ComplexType macOSMinimumOperatingSystem, das das für die Anwendung geltende Mindestbetriebssystem angibt. |
| buildNumber | String | Die Buildnummer des Pakets. Dies sollte mit dem Paket CFBundleShortVersionString der .pkg Datei übereinstimmen. |
| versionNumber | String | Die Versionsnummer des Pakets. Dies sollte mit dem Paket CFBundleVersion in der Packageinfo-Datei übereinstimmen. |
| childApps | macOSLobChildApp-Sammlung | Liste der ComplexType macOSLobChildApp-Objekte. Stellt die Apps dar, die vom Paket installiert werden sollen. |
| md5HashChunkSize | Int32 | Die Blockgröße für MD5-Hash. Dies ist "0" oder leer, wenn das Paket direkt hochgeladen wurde. Wenn die Intune App Wrapping Tool verwendet wird, um eine .intunemac-Datei zu erstellen, befindet sich dieser Wert in der Detection.xml-Datei. |
| md5Hash | String collection | Die MD5-Hashcodes. Dies ist leer, wenn das Paket direkt hochgeladen wurde. Wenn die Intune App Wrapping Tool verwendet wird, um eine .intunemac-Datei zu erstellen, befindet sich dieser Wert in der Detection.xml-Datei. |
| ignoreVersionDetection | Boolesch | Gibt bei TRUE an, dass die App-Version NICHT verwendet wird, um zu erkennen, ob die App auf einem Gerät installiert ist. Gibt bei FALSE an, dass die Version der App verwendet wird, um zu erkennen, ob die App auf einem Gerät installiert ist. Legen Sie dies für Apps, die eine Self-Update-Funktion verwenden, auf true fest. Die Standardeinstellung lautet FALSE. |
| installAsManaged | Boolesch | Gibt bei TRUE an, dass die App als verwaltet installiert wird (erfordert macOS 11.0 und andere Einschränkungen für verwaltete Pakete). Gibt bei FALSE an, dass die App als nicht verwaltet installiert wird. Die Standardeinstellung lautet FALSE. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein macOSLobApp-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: 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
}
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: 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
}
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