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.
Erstellen Sie ein neues win32LobApp-Objekt .
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
POST /deviceAppManagement/mobileApps
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 win32LobApp-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der win32LobApp 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. |
| installCommandLine | Zeichenfolge | Gibt die Befehlszeile zum Installieren dieser App an. Wird zum Installieren der Win32-App verwendet. Beispiel: msiexec /i "Orca.Msi" /qn. |
| uninstallCommandLine | Zeichenfolge | Gibt die Befehlszeile an, über die diese App deinstalliert werden soll. Wird verwendet, um die App zu deinstallieren. Beispiel: msiexec /x "{85F4CBCB-9BBC-4B50-A7D8-E1106771498D}" /qn. |
| applicableArchitectures | windowsArchitecture | Gibt die Windows-Architektur(en) an, auf der diese App installiert werden soll. Die App wird als nicht anwendbar für Geräte behandelt, deren Architekturen nicht mit dem ausgewählten Wert übereinstimmen. Wenn für die allowedArchitectures Eigenschaft ein Wert ungleich NULL angegeben wird, wird der Wert der applicableArchitectures -Eigenschaft auf nonefestgelegt. Der Standardwert ist none. Die möglichen Werte sind: none, x86, x64. Mögliche Werte sind: none, x86, x64, arm, neutral. |
| allowedArchitectures | windowsArchitecture | Gibt die Windows-Architektur(en) an, auf der diese App installiert werden soll. Die App wird als nicht anwendbar für Geräte behandelt, deren Architekturen nicht mit dem ausgewählten Wert übereinstimmen. Wenn für die allowedArchitectures Eigenschaft ein Wert ungleich NULL angegeben wird, wird der Wert der applicableArchitectures -Eigenschaft auf nonefestgelegt. Mögliche Werte sind: null, x86, x64, arm64. Mögliche Werte sind: none, x86, x64, arm, neutral. |
| minimumFreeDiskSpaceInMB | Int32 | Gibt den Wert für den minimalen freien Speicherplatz an, der für die Installation dieser App erforderlich ist. Zulässiger Bereich von 0 bis driver's maximum available free space. |
| minimumMemoryInMB | Int32 | Gibt den Wert für den minimalen physischen Arbeitsspeicher an, der für die Installation dieser App erforderlich ist. Zulässiger Bereich von 0 bis total physical memory from WMI helper. |
| minimumNumberOfProcessors | Int32 | Gibt den Wert für die Mindestanzahl von Prozessoren an, die zum Installieren dieser App erforderlich ist. Der Mindestwert ist 0. |
| minimumCpuSpeedInMHz | Int32 | Gibt den Wert für die minimale CPU-Geschwindigkeit an, die zum Installieren dieser App erforderlich ist. Zulässiger Bereich von 0 bis clock speed from WMI helper. |
| Regeln | win32LobAppRule-Auflistung | Gibt die Erkennungs- und Anforderungsregeln für diese App an. Die möglichen Werte sind: Win32LobAppFileSystemRule, Win32LobAppPowerShellScriptRule, Win32LobAppProductCodeRule, Win32LobAppRegistryRule. |
| installExperience | win32LobAppInstallExperience | Gibt die Installationsoberfläche für diese App an. |
| returnCodes | win32LobAppReturnCode-Auflistung | Gibt die Rückgabecodes für das Verhalten nach der Installation an. |
| msiInformation | win32LobAppMsiInformation | Gibt die MSI-Details an, wenn es sich bei dieser Win32-App um eine MSI-App handelt. |
| setupFilePath | Zeichenfolge | Gibt den relativen Pfad der Setupdatei im verschlüsselten Win32LobApp-Paket an. Beispiel: Intel-SA-00075 Detection and Mitigation Tool.msi. |
| minimumSupportedWindowsRelease | Zeichenfolge | Gibt den Wert für die mindestens unterstützte Windows-Version an. Beispiel: Windows11_23H2. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein win32LobApp-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 2168
{
"@odata.type": "#microsoft.graph.win32LobApp",
"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,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"allowedArchitectures": "x86",
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"rules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRule",
"ruleType": "requirement",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"operationType": "exists",
"operator": "equal",
"comparisonValue": "Comparison Value value"
}
],
"installExperience": {
"@odata.type": "microsoft.graph.win32LobAppInstallExperience",
"runAsAccount": "user",
"deviceRestartBehavior": "allow"
},
"returnCodes": [
{
"@odata.type": "microsoft.graph.win32LobAppReturnCode",
"returnCode": 10,
"type": "success"
}
],
"msiInformation": {
"@odata.type": "microsoft.graph.win32LobAppMsiInformation",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"upgradeCode": "Upgrade Code value",
"requiresReboot": true,
"packageType": "perUser",
"productName": "Product Name value",
"publisher": "Publisher value"
},
"setupFilePath": "Setup File Path value",
"minimumSupportedWindowsRelease": "Minimum Supported Windows Release 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: 2340
{
"@odata.type": "#microsoft.graph.win32LobApp",
"id": "9607b530-b530-9607-30b5-079630b50796",
"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,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"allowedArchitectures": "x86",
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"rules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRule",
"ruleType": "requirement",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"operationType": "exists",
"operator": "equal",
"comparisonValue": "Comparison Value value"
}
],
"installExperience": {
"@odata.type": "microsoft.graph.win32LobAppInstallExperience",
"runAsAccount": "user",
"deviceRestartBehavior": "allow"
},
"returnCodes": [
{
"@odata.type": "microsoft.graph.win32LobAppReturnCode",
"returnCode": 10,
"type": "success"
}
],
"msiInformation": {
"@odata.type": "microsoft.graph.win32LobAppMsiInformation",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"upgradeCode": "Upgrade Code value",
"requiresReboot": true,
"packageType": "perUser",
"productName": "Product Name value",
"publisher": "Publisher value"
},
"setupFilePath": "Setup File Path value",
"minimumSupportedWindowsRelease": "Minimum Supported Windows Release value"
}