deviceAndAppManagementAssignmentFilter aktualisieren

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.

Aktualisieren sie die Eigenschaften eines deviceAndAppManagementAssignmentFilter-Objekts .

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
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/assignmentFilters/{deviceAndAppManagementAssignmentFilterId}

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 objekt deviceAndAppManagementAssignmentFilter an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von deviceAndAppManagementAssignmentFilter erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	String	Schlüssel des Zuweisungsfilters.
createdDateTime	DateTimeOffset	Die Erstellungszeit des Zuweisungsfilters. Der Wert kann nicht geändert werden und wird während des neuen Zuweisungsfilterprozesses automatisch aufgefüllt. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.
lastModifiedDateTime	DateTimeOffset	Zeitpunkt der letzten Änderung des Zuweisungsfilters. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.
displayName	String	Der Name des Zuweisungsfilters.
description	String	Optionale Beschreibung des Zuweisungsfilters.
Plattform	devicePlatformType	Gibt an, dass der Filter auf die Flatform angewendet wird. Mögliche Werte sind android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, androidWorkProfile, unknown, androidAOSP, androidMobileApplicationManagement, iOSMobileApplicationManagement, windowsMobileApplicationManagement. Der Standardfilter wird auf "unknown" angewendet. Mögliche Werte sind: android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, , androidWorkProfilewindows10AndLater, unknown, androidAOSPandroidMobileApplicationManagement, , iOSMobileApplicationManagement, unknownFutureValue, . windowsMobileApplicationManagement
Regel	String	Regeldefinition des Zuweisungsfilters.
roleScopeTags	String collection	Gibt Rollenbereichstags an, die dem Zuweisungsfilter zugewiesen sind.
Nutzlasten	payloadByFilter-Auflistung	Gibt zugeordnete Zuweisungen für einen bestimmten Filter an.
assignmentFilterManagementType	assignmentFilterManagementType	Gibt an, dass der Filter entweder auf den Verwaltungstyp "Geräte" oder "Apps" angewendet wird. Mögliche Werte sind Geräte, Apps. Der Standardfilter wird auf "Geräte" angewendet. Mögliche Werte sind: devices, apps und unknownFutureValue.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein aktualisiertes deviceAndAppManagementAssignmentFilter-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/assignmentFilters/{deviceAndAppManagementAssignmentFilterId}
Content-type: application/json
Content-length: 588

{
  "@odata.type": "#microsoft.graph.deviceAndAppManagementAssignmentFilter",
  "displayName": "Display Name value",
  "description": "Description value",
  "platform": "androidForWork",
  "rule": "Rule value",
  "roleScopeTags": [
    "Role Scope Tags value"
  ],
  "payloads": [
    {
      "@odata.type": "microsoft.graph.payloadByFilter",
      "payloadId": "Payload Id value",
      "payloadType": "deviceConfigurationAndCompliance",
      "groupId": "Group Id value",
      "assignmentFilterType": "include"
    }
  ],
  "assignmentFilterManagementType": "apps"
}

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: 760

{
  "@odata.type": "#microsoft.graph.deviceAndAppManagementAssignmentFilter",
  "id": "819818db-18db-8198-db18-9881db189881",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "description": "Description value",
  "platform": "androidForWork",
  "rule": "Rule value",
  "roleScopeTags": [
    "Role Scope Tags value"
  ],
  "payloads": [
    {
      "@odata.type": "microsoft.graph.payloadByFilter",
      "payloadId": "Payload Id value",
      "payloadType": "deviceConfigurationAndCompliance",
      "groupId": "Group Id value",
      "assignmentFilterType": "include"
    }
  ],
  "assignmentFilterManagementType": "apps"
}