Aktualisieren von "androidForWorkGeneralDeviceConfiguration"

Artikel
09/13/2021
6 Minuten Lesedauer

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 androidForWorkGeneralDeviceConfiguration-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/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

Anforderungsheader

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

Anforderungstext

Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs "androidForWorkGeneralDeviceConfiguration" an.

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

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.
roleScopeTagIds	Zeichenfolgenauflistung	Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceConfiguration.
supportsScopeTags	Boolesch	Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Das Zuweisen zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert false ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies geschieht für Legacyrichtlinien, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal behoben werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Die Anwendbarkeit der Betriebssystem-Edition für diese Richtlinie. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Die Anwendbarkeitsregel für die Betriebssystemversion für diese Richtlinie. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Die Anwendbarkeitsregel für den Gerätemodus für diese Richtlinie. 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.
passwordBlockFaceUnlock	Boolean	Gibt an, ob die Gesichtsentsperrung blockiert werden soll.
passwordBlockFingerprintUnlock	Boolean	Gibt an, ob die Entsperrung durch Fingerabdruck blockiert werden soll.
passwordBlockIrisUnlock	Boolean	Gibt an, ob die Iris-Entsperrung 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	androidForWorkRequiredPasswordType	Geforderter Kennworttyp. Mögliche Werte: `deviceDefault`, `lowSecurityBiometric`, `required`, `atLeastNumeric`, `numericComplex`, `atLeastAlphabetic`, `atLeastAlphanumeric`, `alphanumericWithSymbols`.
workProfileDataSharingType	androidForWorkCrossProfileDataSharingType	Typ der zulässigen Datenfreigabe. Mögliche Werte: `deviceDefault`, `preventAny`, `allowPersonalToWork`, `noRestrictions`.
workProfileBlockNotificationsWhileDeviceLocked	Boolean	Gibt an, ob Benachrichtigungen blockiert werden sollen, während das Gerät gesperrt ist.
workProfileBlockAddingAccounts	Boolesch	Benutzer am Hinzufügen/Entfernen von Konten im Arbeitsprofil hindern.
workProfileBluetoothEnableContactSharing	Boolean	Zulassen, dass Bluetooth-Geräte auf Unternehmenskontakte zugreifen.
workProfileBlockScreenCapture	Boolesch	Bildschirmaufnahme im Arbeitsprofil blockieren.
workProfileBlockCrossProfileCallerId	Boolean	Block display work profile caller ID in personal profile.
workProfileBlockCamera	Boolesch	Arbeitsprofilkamera blockieren.
workProfileBlockCrossProfileContactsSearch	Boolean	Blockieren der Verfügbarkeit von Arbeitsprofilkontakten im persönlichen Profil.
workProfileBlockCrossProfileCopyPaste	Boolesch	Boolean that indicates if the setting disallow cross profile copy/paste is enabled.
workProfileDefaultAppPermissionPolicy	androidForWorkDefaultAppPermissionPolicyType	Geforderter Kennworttyp. Mögliche Werte: `deviceDefault`, `prompt`, `autoGrant`, `autoDeny`.
workProfilePasswordBlockFaceUnlock	Boolesch	Gibt an, ob die Gesichtssperrung für das Arbeitsprofil blockiert werden soll.
workProfilePasswordBlockFingerprintUnlock	Boolesch	Gibt an, ob die Entsperrung des Fingerabdrucks für das Arbeitsprofil blockiert werden soll.
workProfilePasswordBlockIrisUnlock	Boolean	Gibt an, ob die Irissperre für das Arbeitsprofil blockiert werden soll.
workProfilePasswordBlockTrustAgents	Boolesch	Gibt an, ob smart lock und andere Vertrauensstellungs-Agents für das Arbeitsprofil blockiert werden sollen.
workProfilePasswordExpirationDays	Int32	Anzahl der Tage vor Ablauf des Arbeitsprofilkennworts. Gültige Werte: 1 bis 365.
workProfilePasswordMinimumLength	Int32	Mindestlänge des Kennworts für das Arbeitsprofil. Gültige Werte: 4 bis 16.
workProfilePasswordMinNumericCharacters	Int32	Mindestens # der numerischen Zeichen, die im Kennwort für das Arbeitsprofil erforderlich sind. Gültige Werte: 1 bis 10
workProfilePasswordMinNonLetterCharacters	Int32	Mindestanzahl von zeichenfreien Zeichen, die im Kennwort des Arbeitsprofils erforderlich sind. Gültige Werte: 1 bis 10
workProfilePasswordMinLetterCharacters	Int32	Mindestens # der Buchstaben, die im Kennwort für das Arbeitsprofil erforderlich sind. Gültige Werte: 1 bis 10
workProfilePasswordMinLowerCaseCharacters	Int32	Mindestanzahl von Kleinbuchstaben, die im Kennwort des Arbeitsprofils erforderlich sind. Gültige Werte: 1 bis 10
workProfilePasswordMinUpperCaseCharacters	Int32	Mindestens # der großgeschriebenen Zeichen, die im Kennwort für das Arbeitsprofil erforderlich sind. Gültige Werte: 1 bis 10
workProfilePasswordMinSymbolCharacters	Int32	Mindestanzahl von Symbolen, die im Kennwort des Arbeitsprofils 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 zu blockierenden Kennwörter des vorherigen Arbeitsprofils. 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	androidForWorkRequiredPasswordType	Typ des erforderlichen Arbeitsprofilkennworts. Mögliche Werte: `deviceDefault`, `lowSecurityBiometric`, `required`, `atLeastNumeric`, `numericComplex`, `atLeastAlphabetic`, `atLeastAlphanumeric`, `alphanumericWithSymbols`.
workProfileRequirePassword	Boolesch	Kennwort ist für Arbeitsprofil erforderlich oder nicht
securityRequireVerifyApps	Boolean	Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss.
vpnAlwaysOnPackageIdentifier	String	Aktivieren Sie den Sperrmodus für always-on VPN.
vpnEnableAlwaysOnLockdownMode	Boolesch	Aktivieren Sie den Sperrmodus für always-on VPN.
workProfileAllowWidgets	Boolesch	Widgets aus Arbeitsprofil-Apps zulassen.
workProfileBlockPersonalAppInstallsFromUnknownSources	Boolesch	Verhindern von App-Installationen aus unbekannten Quellen im persönlichen Profil.

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 3079

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": 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",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": 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,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": 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: 3251

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "id": "a931a366-a366-a931-66a3-31a966a331a9",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": 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",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": 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,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": true
}

Aktualisieren von "androidForWorkGeneralDeviceConfiguration"

Voraussetzungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback