androidCompliancePolicy erstellen
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.
Erstellt neue Objekte des Typs androidCompliancePolicy.
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
POST /deviceManagement/deviceCompliancePolicies
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 androidCompliancePolicy-Objekt an.
In der folgenden Tabelle sind die Eigenschaften dargestellt, die zum Erstellen der androidCompliancePolicy erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
roleScopeTagIds | Zeichenfolgensammlung | Liste der Bereichstags für diese entitätsbezogene instance. Geerbt von deviceCompliancePolicy. |
id | String | Schlüssel der Entität Geerbt von deviceCompliancePolicy. |
createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceCompliancePolicy. |
description | String | Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceCompliancePolicy. |
lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceCompliancePolicy. |
displayName | String | 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 . |
requiredPasswordComplexity | androidRequiredPasswordComplexity | Gibt die erforderliche Kennwortkomplexität unter Android an. Einer von: NONE, LOW, MEDIUM, HIGH. Dies ist eine neue API für Android 11 und höher. Mögliche Werte: none , low , medium , high |
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 vor dem Zurücksetzen auf Werkseinstellungen zulässigen Anmeldefehler. 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 . |
advancedThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | MDATP Mindestrisikostufe für Mobile Threat Protection erforderlich, um Nichtkonformität zu melden. 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. |
securityBlockDeviceAdministratorManagedDevices | Boolesch | Vom Geräteadministrator verwaltete Geräte blockieren. |
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. |
conditionStatementId | String | Bedingungsanweisungs-ID. |
restrictedApps | Collection von Objekten des Typs appListItem | Auf dem Gerät müssen die angegebenen Apps nicht installiert sein. Diese Auflistung kann maximal 100 Elemente enthalten. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created
und ein Objekt des Typs androidCompliancePolicy im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
Content-type: application/json
Content-length: 1750
{
"@odata.type": "#microsoft.graph.androidCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"advancedThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"securityBlockDeviceAdministratorManagedDevices": 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,
"conditionStatementId": "Condition Statement Id value",
"restrictedApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id 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: 1922
{
"@odata.type": "#microsoft.graph.androidCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"id": "752c820f-820f-752c-0f82-2c750f822c75",
"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",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"advancedThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"securityBlockDeviceAdministratorManagedDevices": 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,
"conditionStatementId": "Condition Statement Id value",
"restrictedApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
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 unterFeedback senden und anzeigen für