Aktualisieren von androidWorkProfileGeneralDeviceConfiguration

Namespace: microsoft.graph

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

Aktualisieren sie die Eigenschaften eines androidWorkProfileGeneralDeviceConfiguration-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/deviceConfigurations/{deviceConfigurationId}

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 androidWorkProfileGeneralDeviceConfiguration an .

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

Eigenschaft Typ Beschreibung
id String 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 String 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 Boolesch Blockieren des Hinzufügens/Entfernens von Konten im Arbeitsprofil durch Benutzer.
workProfileBluetoothEnableContactSharing Boolesch Zulassen, dass Bluetooth-Geräte auf Unternehmenskontakte zugreifen können.
workProfileBlockScreenCapture Boolesch Bildschirmaufnahme im Arbeitsprofil blockieren.
workProfileBlockCrossProfileCallerId Boolesch Anzeigen der Anrufer-ID des Arbeitsprofils im persönlichen Profil blockieren.
workProfileBlockCamera Boolesch Arbeitsprofilkamera blockieren.
workProfileBlockCrossProfileContactsSearch Boolesch Blockieren der Verfügbarkeit von Arbeitsprofilkontakten im persönlichen Profil.
workProfileBlockCrossProfileCopyPaste Boolesch Boolescher Wert, der angibt, ob die Einstellung Das profilübergreifende Kopieren/Einfügen nicht zulassen aktiviert ist.
workProfileDefaultAppPermissionPolicy androidWorkProfileDefaultAppPermissionPolicyType Geforderter Kennworttyp. Mögliche Werte: deviceDefault, prompt, autoGrant, autoDeny
workProfilePasswordBlockFingerprintUnlock Boolesch Gibt an, ob die Entsperrung per Fingerabdruck für arbeitsprofile blockiert werden soll.
workProfilePasswordBlockTrustAgents Boolesch Gibt an, ob Smart Lock und andere vertrauenswürdige Agents für Arbeitsprofile blockiert werden sollen.
workProfilePasswordExpirationDays Int32 Anzahl der Tage, bevor das Arbeitsprofilkennwort abläuft. Gültige Werte: 1 bis 365.
workProfilePasswordMinimumLength Int32 Minimale Länge des Arbeitsprofilkennworts. Gültige Werte: 4 bis 16.
workProfilePasswordMinNumericCharacters Int32 Mindestens erforderliche Anzahl numerischer Zeichen im Arbeitsprofilkennwort. Gültige Werte 1 bis 10
workProfilePasswordMinNonLetterCharacters Int32 Mindestens erforderliche Anzahl von Zeichen ohne Buchstaben im Arbeitsprofilkennwort. Gültige Werte 1 bis 10
workProfilePasswordMinLetterCharacters Int32 Minimale Anzahl 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 Mindestens erforderliche Anzahl von Symbolen im Arbeitsprofilkennwort. Gültige Werte 1 bis 10
workProfilePasswordMinutesOfInactivityBeforeScreenTimeout Int32 Zeitraum von Inaktivität in Minuten, bevor es zu einem Bildschirmtimeout kommt.
workProfilePasswordPreviousPasswordBlockCount Int32 Anzahl der zuvor 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 Boolesch Das Kennwort ist für das Arbeitsprofil erforderlich oder nicht erforderlich.
securityRequireVerifyApps Boolean Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss.

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
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 200 OK
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
}