Aktualisieren von "androidForWorkCompliancePolicy"

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.

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

HTTP-Anforderung

PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "androidForWorkCompliancePolicy" an.

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

Eigenschaft	Typ	Beschreibung
roleScopeTagIds	Zeichenfolgenauflistung	Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceCompliancePolicy.
id	Zeichenfolge	Schlüssel der Entität Geerbt von deviceCompliancePolicy.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceCompliancePolicy.
description	Zeichenfolge	Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceCompliancePolicy.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceCompliancePolicy.
displayName	Zeichenfolge	Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceCompliancePolicy.
Version	Int32	Version der Gerätekonfiguration. Geerbt von deviceCompliancePolicy.
passwordRequired	Boolean	Legt fest, dass zum Entsperren des Geräts ein Kennwort erforderlich ist.
passwordMinimumLength	Int32	Mindestlänge des Kennworts. Gültige Werte: 4 bis 16.
passwordRequiredType	androidRequiredPasswordType	Typ der Zeichen im Kennwort. Mögliche Werte: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordMinutesOfInactivityBeforeLock	Int32	Zeitraum von Inaktivität in Minuten, nach dem die Eingabe eines Kennworts gefordert wird
passwordExpirationDays	Int32	Zeit in Tagen bis zum Ablaufen des Kennworts. Gültige Werte: 1 bis 365.
passwordPreviousPasswordBlockCount	Int32	Anzahl der zuletzt verwendeten Kennwörter, die nicht erneut verwendet werden dürfen. Gültige Werte: 1 bis 24.
passwordSignInFailureCountBeforeFactoryReset	Int32	Anzahl der zulässigen Anmeldefehler vor der Zurücksetzung auf die Werkseinstellungen. Gültige Werte: 1 bis 16
securityPreventInstallAppsFromUnknownSources	Boolean	Legt fest, dass Geräte die Installation von Apps aus unbekannten Quellen nicht zulassen dürfen.
securityDisableUsbDebugging	Boolean	Deaktiviert das USB-Debuggen auf Android-Geräten.
securityRequireVerifyApps	Boolean	Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss.
deviceThreatProtectionEnabled	Boolean	Legt fest, dass auf Geräten der Gerätebedrohungsschutz aktiviert sein muss.
deviceThreatProtectionRequiredSecurityLevel	deviceThreatProtectionLevel	Legt die Mindestrisikostufe fest, ab der Mobile Threat Protection einen Konformitätsverstoß melden soll. Mögliche Werte sind: unavailable, secured, low, medium, high und notSet.
securityBlockJailbrokenDevices	Boolean	Legt fest, dass weder gerootete Geräte verwendet werden dürfen noch Geräte, für die ein Jailbreak durchgeführt wurde.
osMinimumVersion	String	Mindestversion von Android
osMaximumVersion	String	Maximalversion von Android
minAndroidSecurityPatchLevel	String	Mindestens geforderter Sicherheitspatchlevel von Android
storageRequireEncryption	Boolean	Legt fest, dass auf Android-Geräten Verschlüsselung aktiviert sein muss.
securityRequireSafetyNetAttestationBasicIntegrity	Boolean	Legt fest, dass das Gerät die SafetyNet-Basisintegritätsprüfung bestanden haben muss.
securityRequireSafetyNetAttestationCertifiedDevice	Boolean	Legt fest, dass das Gerät die Prüfung zum SafetyNet-zertifizierten Gerät bestanden haben muss.
securityRequireGooglePlayServices	Boolean	Legt fest, dass Google Play Services auf dem Gerät installiert und aktiviert sein muss.
securityRequireUpToDateSecurityProviders	Boolean	Legt fest, dass die Sicherheitsanbieter des Geräts aktuell sein müssen. Die aktuelle Version von Google Play Services muss auf dem Gerät installiert und aktiviert sein.
securityRequireCompanyPortalAppIntegrity	Boolean	Legt fest, dass das Gerät die Laufzeitintegritätsprüfung für Unternehmensportal-Client-Apps bestanden haben muss.
securityRequiredAndroidSafetyNetEvaluationType	androidSafetyNetEvaluationType	Fordern Sie einen bestimmten SafetyNet-Evaluierungstyp für die Compliance an. Mögliche Werte sind: basic und hardwareBacked.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes Objekt des Typs "androidForWorkCompliancePolicy" im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
Content-type: application/json
Content-length: 1354

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}

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

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "id": "a8d667bd-67bd-a8d6-bd67-d6a8bd67d6a8",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}