androidWorkProfileGeneralDeviceConfiguration erstellen

Namespace: microsoft.graph

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

Erstellen Sie ein neues androidWorkProfileGeneralDeviceConfiguration-Objekt .

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

POST /deviceManagement/deviceConfigurations

Anforderungsheader

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

Anforderungstext

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

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

Eigenschaft Typ Beschreibung
id Zeichenfolge Schlüssel der Entität Geerbt von deviceConfiguration.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration.
createdDateTime DateTimeOffset Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration.
description String Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
displayName Zeichenfolge Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
Version Int32 Version der Gerätekonfiguration. Geerbt von deviceConfiguration.
passwordBlockFingerprintUnlock Boolean Gibt an, ob die Entsperrung durch Fingerabdruck blockiert werden soll.
passwordBlockTrustAgents Boolean Gibt an, ob Smart Lock oder andere Vertrauensstellungs-Agents blockiert werden sollen.
passwordExpirationDays Int32 Zeit in Tagen bis zum Ablaufen des Kennworts. Gültige Werte: 1 bis 365.
passwordMinimumLength Int32 Mindestlänge von Kennwörtern Gültige Werte: 4 bis 16.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Zeitraum von Inaktivität in Minuten, bevor es zu einem Bildschirmtimeout kommt.
passwordPreviousPasswordBlockCount Int32 Anzahl der zuletzt verwendeten Kennwörter, die nicht erneut verwendet werden dürfen. Gültige Werte: 0 bis 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Legt fest, nach wie vielen fehlgeschlagenen Anmeldeversuchen eine Zurücksetzung auf die Werkseinstellungen durchgeführt wird. Gültige Werte 1 bis 16
passwordRequiredType androidWorkProfileRequiredPasswordType Geforderter Kennworttyp. Mögliche Werte: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols.
workProfileDataSharingType androidWorkProfileCrossProfileDataSharingType Typ der zulässigen Datenfreigabe. Mögliche Werte: deviceDefault, preventAny, allowPersonalToWork, noRestrictions
workProfileBlockNotificationsWhileDeviceLocked Boolesch Gibt an, ob Benachrichtigungen blockiert werden sollen, während das Gerät gesperrt ist.
workProfileBlockAddingAccounts Boolean Benutzer am Hinzufügen/Entfernen von Konten im Arbeitsprofil hindern.
workProfileBluetoothEnableContactSharing Boolesch Zulassen, dass Bluetooth-Geräte auf Unternehmenskontakte zugreifen.
workProfileBlockScreenCapture Boolesch Bildschirmaufnahme im Arbeitsprofil blockieren.
workProfileBlockCrossProfileCallerId Boolescher Wert Die Anrufer-ID des Arbeitsprofils im persönlichen Profil blockieren.
workProfileBlockCamera Boolean Arbeitsprofilkamera blockieren.
workProfileBlockCrossProfileContactsSearch Boolean Blockieren der Verfügbarkeit von Geschäftsprofilkontakten im persönlichen Profil.
workProfileBlockCrossProfileCopyPaste Boolean Boolean that indicates if the setting disallow cross profile copy/paste is enabled.
workProfileDefaultAppPermissionPolicy androidWorkProfileDefaultAppPermissionPolicyType Geforderter Kennworttyp. Mögliche Werte: deviceDefault, prompt, autoGrant, autoDeny
workProfilePasswordBlockFingerprintUnlock Boolean Gibt an, ob die Fingerabdrucksperre für das Arbeitsprofil blockiert werden soll.
workProfilePasswordBlockTrustAgents Boolean Gibt an, ob smarte Sperre und andere vertrauenswürdige Agents für das Arbeitsprofil blockiert werden sollen.
workProfilePasswordExpirationDays Int32 Anzahl der Tage, bevor das Arbeitsprofilkennwort abläuft. Gültige Werte: 1 bis 365.
workProfilePasswordMinimumLength Int32 Mindestlänge des Arbeitsprofilkennworts. Gültige Werte: 4 bis 16.
workProfilePasswordMinNumericCharacters Int32 Mindestanzahl numerischer Zeichen, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinNonLetterCharacters Int32 Mindestanzahl von zeichenfreien Zeichen, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinLetterCharacters Int32 Mindestanzahl von Buchstabenzeichen, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinLowerCaseCharacters Int32 Mindestanzahl von Kleinbuchstaben, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinUpperCaseCharacters Int32 Mindestanzahl von Großbuchstaben, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinSymbolCharacters Int32 Mindestanzahl von Symbolen, die im Arbeitsprofilkennwort erforderlich sind. Gültige Werte 1 bis 10
workProfilePasswordMinutesOfInactivityBeforeScreenTimeout Int32 Zeitraum von Inaktivität in Minuten, bevor es zu einem Bildschirmtimeout kommt.
workProfilePasswordPreviousPasswordBlockCount Int32 Anzahl der vorherigen zu blockierenden Arbeitsprofilkennwörter. Gültige Werte: 0 bis 24.
workProfilePasswordSignInFailureCountBeforeFactoryReset Int32 Anzahl der zulässigen Anmeldefehler, bevor das Arbeitsprofil entfernt und alle Unternehmensdaten gelöscht werden. Gültige Werte 1 bis 16
workProfilePasswordRequiredType androidWorkProfileRequiredPasswordType Typ des erforderlichen Arbeitsprofilkennworts. Mögliche Werte: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols.
workProfileRequirePassword Boolean Für das Arbeitsprofil ist ein Kennwort erforderlich oder nicht.
securityRequireVerifyApps Boolean Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein Objekt des Typs "androidWorkProfileGeneralDeviceConfiguration " im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1831

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": 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: 2003

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "id": "6decda7e-da7e-6dec-7eda-ec6d7edaec6d",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true
}