Erstellen von „androidGeneralDeviceConfiguration“
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.
Diese Methode erstellt ein neues Objekt des Typs androidGeneralDeviceConfiguration.
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/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „androidGeneralDeviceConfiguration“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „androidGeneralDeviceConfiguration“ 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 | String collection | Liste der Bereichstags für diese entitätsbezogene instance. Geerbt von deviceConfiguration. |
supportsScopeTags | Boolesch | Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Die Zuweisung zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert false ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies tritt bei legacy-Richtlinien auf, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal aufgelöst werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die Anwendbarkeit der Betriebssystemedition für diese Richtlinie. Geerbt von deviceConfiguration. |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die Anwendbarkeitsregel der 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 | String | Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
Version | Int32 | Version der Gerätekonfiguration. Geerbt von deviceConfiguration. |
appsBlockClipboardSharing | Boolean | Gibt an, ob die gemeinsame Nutzung der Zwischenablage zum Kopieren und Einfügen zwischen Anwendungen blockiert werden soll. |
appsBlockCopyPaste | Boolean | Gibt an, ob Kopieren und Einfügen zwischen Anwendungen blockiert werden soll. |
appsBlockYouTube | Boolean | Gibt an, ob die YouTube-App blockiert werden soll. |
bluetoothBlocked | Boolean | Gibt an, ob Bluetooth blockiert werden soll. |
cameraBlocked | Boolean | Gibt an, ob die Verwendung der Kamera blockiert werden soll. |
cellularBlockDataRoaming | Boolean | Gibt an, ob Datenroaming blockiert werden soll. |
cellularBlockMessaging | Boolean | Gibt an, ob SMS-/MMS-Nachrichten blockiert werden sollen. |
cellularBlockVoiceRoaming | Boolean | Gibt an, ob Sprachroaming blockiert werden soll. |
cellularBlockWifiTethering | Boolean | Gibt an, ob die Synchronisierung von WLAN-Tethering blockiert werden soll. |
compliantAppsList | Collection von Objekten des Typs appListItem | Liste aller Apps, für die die Konformitätsrichtlinie gilt (Zulassungsliste oder Sperrliste, gesteuert über „compliantAppListType“). Diese Collection darf maximal 10.000 Elemente enthalten. |
compliantAppListType | appListType | Typ der in „compliantAppsList“ definierten Liste. Mögliche Werte sind: none , appsInListCompliant und appsNotInListCompliant . |
diagnosticDataBlockSubmission | Boolean | Gibt an, ob die Übermittlung von Diagnosedaten blockiert werden soll. |
locationServicesBlocked | Boolean | Gibt an, ob die Ortungsdienste blockiert werden sollen. |
googleAccountBlockAutoSync | Boolean | Gibt an, ob die automatische Synchronisierung von Google-Konten blockiert werden soll. |
googlePlayStoreBlocked | Boolean | Gibt an, ob der Google Play-Store blockiert werden soll. |
kioskModeBlockSleepButton | Boolean | Gibt an, ob die Standbytaste im Kioskmodus blockiert werden soll. |
kioskModeBlockVolumeButtons | Boolean | Gibt an, ob die Lautstärkeregler im Kioskmodus blockiert werden sollen. |
dateAndTimeBlockChanges | Boolesch | Gibt an, ob das Ändern von Datum und Uhrzeit im KNOX-Modus blockiert werden soll. |
kioskModeApps | Collection von Objekten des Typs appListItem | Eine Liste der Apps, die ausgeführt werden können, wenn sich das Gerät im Kioskmodus befindet. Diese Sammlung darf maximal 500 Elemente enthalten. |
nfcBlocked | Boolean | Gibt an, ob NFC (Near Field Communication) blockiert werden soll. |
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 | androidRequiredPasswordType | Geforderter Kennworttyp. 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 API für Android 11 und höher. Mögliche Werte: none , low , medium , high |
passwordRequired | Boolean | Gibt an, ob ein Kennwort erforderlich ist. |
powerOffBlocked | Boolean | Gibt an, ob das Ausschalten des Geräts blockiert werden soll. |
factoryResetBlocked | Boolean | Gibt an, ob verhindert werden soll, dass der Benutzer eine Zurücksetzung auf die Werkseinstellungen durchführt. |
screenCaptureBlocked | Boolean | Gibt an, ob Screenshots blockiert werden sollen. |
deviceSharingAllowed | Boolean | Gibt an, ob der Gerätefreigabemodus zugelassen wird. |
storageBlockGoogleBackup | Boolean | Gibt an, ob die Google-Sicherung blockiert werden soll. |
storageBlockRemovableStorage | Boolean | Gibt an, ob die Verwendung von Wechselmedien blockiert werden soll. |
storageRequireDeviceEncryption | Boolean | Gibt an, ob eine Geräteverschlüsselung erforderlich ist. |
storageRequireRemovableStorageEncryption | Boolean | Gibt an, ob die Verschlüsselung von Wechselmedien erforderlich ist. |
voiceAssistantBlocked | Boolean | Gibt an, ob die Verwendung des Sprach-Assistenten blockiert werden soll. |
voiceDialingBlocked | Boolean | Gibt an, ob das Sprachwahlverfahren blockiert werden soll. |
webBrowserBlockPopups | Boolean | Gibt an, ob Popups innerhalb des Webbrowsers blockiert werden sollen. |
webBrowserBlockAutofill | Boolean | Gibt an, ob das AutoAusfüllen-Feature des Webbrowsers blockiert werden soll. |
webBrowserBlockJavaScript | Boolean | Gibt an, ob JavaScript im Webbrowser blockiert werden soll. |
webBrowserBlocked | Boolean | Gibt an, ob der Webbrowser blockiert werden soll. |
webBrowserCookieSettings | webBrowserCookieSettings | Cookieeinstellungen des Webbrowsers. Mögliche Werte: browserDefault , blockAlways , allowCurrentWebSite , allowFromWebsitesVisited , allowAlways . |
wiFiBlocked | Boolean | Gibt an, ob die WLAN-Synchronisierung blockiert werden soll. |
appsInstallAllowList | Collection von Objekten des Typs appListItem | Liste von Apps, die auf dem KNOX-Gerät installiert werden dürfen. Diese Sammlung darf maximal 500 Elemente enthalten. |
appsLaunchBlockList | Collection von Objekten des Typs appListItem | Liste von Apps, die auf dem KNOX-Gerät nicht gestartet werden dürfen. Diese Sammlung darf maximal 500 Elemente enthalten. |
appsHideList | Collection von Objekten des Typs appListItem | Liste von Apps, die auf dem KNOX-Gerät ausgeblendet werden sollen. Diese Sammlung darf maximal 500 Elemente enthalten. |
securityRequireVerifyApps | Boolean | Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created
und ein Objekt des Typs androidGeneralDeviceConfiguration 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: 3974
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"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,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"dateAndTimeBlockChanges": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"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: 4146
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"id": "9e00d534-d534-9e00-34d5-009e34d5009e",
"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,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"dateAndTimeBlockChanges": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"securityRequireVerifyApps": true
}
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