Erstellen von "androidForWorkGeneralDeviceConfiguration"
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.
Erstellen eines neuen 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
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
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 | Zeichenfolge | 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 | Boolean | 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 | Zeichenfolge | 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 | Boolesch | 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 | Boolesch | 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 | Boolean | Bildschirmaufnahme im Arbeitsprofil blockieren. |
| workProfileBlockCrossProfileCallerId | Boolesch | 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 | Boolean | 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 | Boolean | 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 | Zeichenfolge | Aktivieren Sie den Sperrmodus für always-on VPN. |
| vpnEnableAlwaysOnLockdownMode | Boolean | Aktivieren Sie den Sperrmodus für always-on VPN. |
| workProfileAllowWidgets | Boolean | Widgets aus Arbeitsprofil-Apps zulassen. |
| workProfileBlockPersonalAppInstallsFromUnknownSources | Boolean | Verhindern von App-Installationen aus unbekannten Quellen im persönlichen Profil. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode und ein Objekt des Typs 201 Created "androidForWorkGeneralDeviceConfiguration" im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
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 201 Created
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
}
Feedback
Feedback senden und anzeigen für