Erstellen von win32LobApp
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 win32LobApp-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 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. |
| 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. |
| installCommandLine | String | Die Befehlszeile zum Installieren dieser App |
| uninstallCommandLine | String | Die Befehlszeile zum Deinstallieren dieser App |
| applicableArchitectures | windowsArchitecture | Die Windows-Architekturen, für die diese App ausgeführt werden kann. Mögliche Werte sind: none, x86, x64, arm, neutral und arm64. |
| minimumSupportedOperatingSystem | windowsMinimumOperatingSystem | Der Wert für die Mindestversion des verwendbaren Betriebssystems. |
| minimumFreeDiskSpaceInMB | Int32 | Der Wert für den minimalen freien Speicherplatz, der für die Installation dieser App erforderlich ist. |
| minimumMemoryInMB | Int32 | Der Wert für den minimalen physischen Arbeitsspeicher, der für die Installation dieser App erforderlich ist. |
| minimumNumberOfProcessors | Int32 | Der Wert für die Mindestanzahl von Prozessoren, die zum Installieren dieser App erforderlich ist. |
| minimumCpuSpeedInMHz | Int32 | Der Wert für die minimale CPU-Geschwindigkeit, die zum Installieren dieser App erforderlich ist. |
| detectionRules | win32LobAppDetection-Auflistung | Die Erkennungsregeln zum Erkennen der Win32 Line of Business(LoB)-App. |
| AnforderungSregeln | win32LobAppRequirement-Sammlung | Die Anforderungsregeln zum Erkennen der Win32 Line of Business(LoB)-App. |
| Regeln | win32LobAppRule-Auflistung | Die Erkennungs- und Anforderungsregeln für diese App. |
| installExperience | win32LobAppInstallExperience | Die Installationsoberfläche für diese App. |
| returnCodes | win32LobAppReturnCode-Auflistung | Die Rückgabecodes für das Verhalten nach der Installation. |
| msiInformation | win32LobAppMsiInformation | Die MSI-Details, ob es sich bei dieser Win32-App um eine MSI-App handelt. |
| setupFilePath | String | Der relative Pfad der Setupdatei im verschlüsselten Win32LobApp-Paket. |
| minimumSupportedWindowsRelease | String | Der Wert für die unterstützte Mindestversion von Windows. |
| displayVersion | String | Die Version, die in der Benutzeroberfläche für diese App angezeigt wird. |
| allowAvailableUninstall | Boolesch | Gibt bei TRUE an, dass die Deinstallation über das Unternehmensportal für die Windows-App (Win32) mit der Zuweisung Verfügbar unterstützt wird. Gibt bei FALSE an, dass die Deinstallation für die Windows-App (Win32) mit der Zuweisung Verfügbar nicht unterstützt wird. Der Standardwert ist FALSE. |
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/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 3518
{
"@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",
"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,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"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
},
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"detectionRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryDetection",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists",
"operator": "equal",
"detectionValue": "Detection Value value"
}
],
"requirementRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRequirement",
"operator": "equal",
"detectionValue": "Detection Value value",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists"
}
],
"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",
"maxRunTimeInMinutes": 3,
"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",
"displayVersion": "Display Version value",
"allowAvailableUninstall": 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: 3690
{
"@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",
"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,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"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
},
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"detectionRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryDetection",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists",
"operator": "equal",
"detectionValue": "Detection Value value"
}
],
"requirementRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRequirement",
"operator": "equal",
"detectionValue": "Detection Value value",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists"
}
],
"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",
"maxRunTimeInMinutes": 3,
"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",
"displayVersion": "Display Version value",
"allowAvailableUninstall": 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