Freigeben über


Erstellen von „androidGeneralDeviceConfiguration“

Namespace: microsoft.graph

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.

Weltweiter Service 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

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über 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.
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.
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.
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/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 3033

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "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,
  "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",
  "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: 3205

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "id": "9e00d534-d534-9e00-34d5-009e34d5009e",
  "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,
  "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,
  "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",
  "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
}