Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren sie die Eigenschaften eines macOSLobApp-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | 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 |
| Application | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceAppManagement/mobileApps/{mobileAppId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über 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. |
| 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. Die möglichen Werte sind: notPublished, processing, published. |
| 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 | Zeichenfolge | Die primäre bundleId des Pakets. |
| minimumSupportedOperatingSystem | macOSMinimumOperatingSystem | ComplexType macOSMinimumOperatingSystem, das das für die Anwendung geltende Mindestbetriebssystem angibt. |
| buildNumber | Zeichenfolge | Die Buildnummer des Pakets. Dies sollte mit dem Paket CFBundleShortVersionString der .pkg Datei übereinstimmen. |
| versionNumber | Zeichenfolge | 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 | Boolean | 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 | Boolean | 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 einen 200 OK Antwortcode und ein aktualisiertes macOSLobApp-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1523
{
"@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",
"publishingState": "processing",
"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
},
"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 200 OK
Content-Type: application/json
Content-Length: 1695
{
"@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",
"publishingState": "processing",
"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
},
"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
}