Feedback Bearbeiten

WindowsAppX aktualisieren

  • Artikel
  • 4 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Dient zum Aktualisieren der Eigenschaften eines windowsAppX-Objekts.

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) DeviceManagementApps.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung DeviceManagementApps.ReadWrite.All

HTTP-Anforderung

PATCH /deviceAppManagement/mobileApps/{mobileAppId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app

Anforderungsheader

Kopfzeile Wert
Authorization Bearer<token> erforderlich
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des windowsAppX-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs "windowsAppX"erstellen.

Eigenschaft Typ Beschreibung
id String Schlüssel der Entität Geerbt von mobileApp.
displayName String Der vom Administrator bereitgestellte oder importierte Titel der App. Geerbt von mobileApp.
description Zeichenfolge 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. Geerbt von mobileApp.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung der App. 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 . Geerbt von mobileApp.
publishingState mobileAppPublishingState Der Veröffentlichungsstatus für die App. Die App kann nicht zugewiesen werden, solange sie nicht veröffentlicht wurde. Geerbt von mobileApp. Mögliche Werte sind: notPublished, processing und published.
isAssigned Boolean Der Wert, der angibt, ob die App mindestens einer Gruppe zugewiesen ist. Geerbt von mobileApp.
roleScopeTagIds Zeichenfolgenauflistung Liste der Bereichs-Tag-IDs für diese mobile App. Geerbt von mobileApp.
dependentAppCount Int32 Die Gesamtzahl der Abhängigkeiten, über die die untergeordnete App verfügt. Geerbt von mobileApp.
supersedingAppCount Int32 Die Gesamtzahl der Apps, die diese App direkt oder indirekt ersetzt. Geerbt von mobileApp.
supersededAppCount Int32 Die Gesamtzahl der Apps, durch die diese App direkt oder indirekt abgelöst wird. 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. 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 und arm64.
identityName String Identitätsname
identityPublisherHash String Der Hash des Identitätsherausgebers.
identityResourceIdentifier String Der Identitätsressourcenbezeichner.
isBundle Boolean Gibt an, ob die App ein Bundle ist.
minimumSupportedOperatingSystem windowsMinimumOperatingSystem Der Wert für die Mindestversion des verwendbaren Betriebssystems.
identityVersion String Die Version der Identität

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes windowsAppX-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1562

{
  "@odata.type": "#microsoft.graph.windowsAppX",
  "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",
  "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 200 OK
Content-Type: application/json
Content-Length: 1734

{
  "@odata.type": "#microsoft.graph.windowsAppX",
  "id": "b5179a93-9a93-b517-939a-17b5939a17b5",
  "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",
  "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"
}