Aktualisieren von „androidGeneralDeviceConfiguration“Update androidGeneralDeviceConfiguration

Namespace: microsoft.graphNamespace: microsoft.graph

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Diese Methode aktualisiert die Eigenschaften von Objekten des Typs androidGeneralDeviceConfiguration.Update the properties of a androidGeneralDeviceConfiguration object.

VoraussetzungenPrerequisites

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten)Permissions (from most to least privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP Request

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer<token> erforderlichBearer <token> Required.
AnnehmenAccept application/jsonapplication/json

AnforderungstextRequest body

Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs androidGeneralDeviceConfiguration an.In the request body, supply a JSON representation for the androidGeneralDeviceConfiguration object.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs androidGeneralDeviceConfiguration erstellen.The following table shows the properties that are required when you create the androidGeneralDeviceConfiguration.

EigenschaftProperty TypType BeschreibungDescription
idid ZeichenfolgeString Schlüssel der EntitätKey of the entity. Geerbt von deviceConfiguration.Inherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der letzten Änderung des Objekts.DateTime the object was last modified. Geerbt von deviceConfiguration.Inherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Erstellung des Objekts.DateTime the object was created. Geerbt von deviceConfiguration.Inherited from deviceConfiguration
descriptiondescription StringString Beschreibung der Gerätekonfiguration (vom Administrator festgelegt).Admin provided description of the Device Configuration. Geerbt von deviceConfiguration.Inherited from deviceConfiguration
displayNamedisplayName StringString Name der Gerätekonfiguration (vom Administrator festgelegt).Admin provided name of the device configuration. Geerbt von deviceConfigurationInherited from deviceConfiguration
Versionversion Int32Int32 Version der Gerätekonfiguration.Version of the device configuration. Geerbt von deviceConfiguration.Inherited from deviceConfiguration
appsBlockClipboardSharingappsBlockClipboardSharing BooleschBoolean Gibt an, ob die gemeinsame Nutzung der Zwischenablage zum Kopieren und Einfügen zwischen Anwendungen blockiert werden soll.Indicates whether or not to block clipboard sharing to copy and paste between applications.
appsBlockCopyPasteappsBlockCopyPaste BooleschBoolean Gibt an, ob Kopieren und Einfügen zwischen Anwendungen blockiert werden soll.Indicates whether or not to block copy and paste within applications.
appsBlockYouTubeappsBlockYouTube BooleschBoolean Gibt an, ob die YouTube-App blockiert werden soll.Indicates whether or not to block the YouTube app.
bluetoothBlockedbluetoothBlocked BooleschBoolean Gibt an, ob Bluetooth blockiert werden soll.Indicates whether or not to block Bluetooth.
cameraBlockedcameraBlocked BooleschBoolean Gibt an, ob die Verwendung der Kamera blockiert werden soll.Indicates whether or not to block the use of the camera.
cellularBlockDataRoamingcellularBlockDataRoaming BooleschBoolean Gibt an, ob Datenroaming blockiert werden soll.Indicates whether or not to block data roaming.
cellularBlockMessagingcellularBlockMessaging BooleschBoolean Gibt an, ob SMS-/MMS-Nachrichten blockiert werden sollen.Indicates whether or not to block SMS/MMS messaging.
cellularBlockVoiceRoamingcellularBlockVoiceRoaming Boolescher WertBoolean Gibt an, ob Sprachroaming blockiert werden soll.Indicates whether or not to block voice roaming.
cellularBlockWifiTetheringcellularBlockWiFiTethering BooleschBoolean Gibt an, ob die Synchronisierung von WLAN-Tethering blockiert werden soll.Indicates whether or not to block syncing Wi-Fi tethering.
compliantAppsListcompliantAppsList appListItem-SammlungappListItem collection Liste aller Apps, für die die Konformitätsrichtlinie gilt (Zulassungsliste oder Sperrliste, gesteuert über „compliantAppListType“).List of apps in the compliance (either allow list or block list, controlled by CompliantAppListType). Diese Collection darf maximal 10.000 Elemente enthalten.This collection can contain a maximum of 10000 elements.
compliantAppListTypecompliantAppListType appListTypeappListType Typ der in „compliantAppsList“ definierten Liste.Type of list that is in the CompliantAppsList. Mögliche Werte sind: none, appsInListCompliant und appsNotInListCompliant.Possible values are: none, appsInListCompliant, appsNotInListCompliant.
diagnosticDataBlockSubmissiondiagnosticDataBlockSubmission BooleschBoolean Gibt an, ob die Übermittlung von Diagnosedaten blockiert werden soll.Indicates whether or not to block diagnostic data submission.
locationServicesBlockedlocationServicesBlocked BooleschBoolean Gibt an, ob die Ortungsdienste blockiert werden sollen.Indicates whether or not to block location services.
googleAccountBlockAutoSyncgoogleAccountBlockAutoSync BooleschBoolean Gibt an, ob die automatische Synchronisierung von Google-Konten blockiert werden soll.Indicates whether or not to block Google account auto sync.
googlePlayStoreBlockedgooglePlayStoreBlocked BooleschBoolean Gibt an, ob der Google Play-Store blockiert werden soll.Indicates whether or not to block the Google Play store.
kioskModeBlockSleepButtonkioskModeBlockSleepButton BooleschBoolean Gibt an, ob die Standbytaste im Kioskmodus blockiert werden soll.Indicates whether or not to block the screen sleep button while in Kiosk Mode.
kioskModeBlockVolumeButtonskioskModeBlockVolumeButtons BooleschBoolean Gibt an, ob die Lautstärkeregler im Kioskmodus blockiert werden sollen.Indicates whether or not to block the volume buttons while in Kiosk Mode.
kioskModeAppskioskModeApps Collection von Objekten des Typs appListItemappListItem collection Eine Liste der Apps, die ausgeführt werden können, wenn sich das Gerät im Kioskmodus befindet.A list of apps that will be allowed to run when the device is in Kiosk Mode. Diese Sammlung darf maximal 500 Elemente enthalten.This collection can contain a maximum of 500 elements.
nfcBlockednfcBlocked Boolescher WertBoolean Gibt an, ob NFC (Near Field Communication) blockiert werden soll.Indicates whether or not to block Near-Field Communication.
passwordBlockFingerprintUnlockpasswordBlockFingerprintUnlock BooleschBoolean Gibt an, ob die Entsperrung durch Fingerabdruck blockiert werden soll.Indicates whether or not to block fingerprint unlock.
passwordBlockTrustAgentspasswordBlockTrustAgents BooleanBoolean Gibt an, ob Smart Lock oder andere Vertrauensstellungs-Agents blockiert werden sollen.Indicates whether or not to block Smart Lock and other trust agents.
passwordExpirationDayspasswordExpirationDays Int32Int32 Zeit in Tagen bis zum Ablaufen des Kennworts.Number of days before the password expires. Gültige Werte: 1 bis 365.Valid values 1 to 365
passwordMinimumLengthpasswordMinimumLength Int32Int32 Mindestlänge von KennwörternMinimum length of passwords. Gültige Werte: 4 bis 16.Valid values 4 to 16
passwordMinutesOfInactivityBeforeScreenTimeoutpasswordMinutesOfInactivityBeforeScreenTimeout Int32Int32 Zeitraum von Inaktivität in Minuten, bevor es zu einem Bildschirmtimeout kommt.Minutes of inactivity before the screen times out.
passwordPreviousPasswordBlockCountpasswordPreviousPasswordBlockCount Int32Int32 Anzahl der zuletzt verwendeten Kennwörter, die nicht erneut verwendet werden dürfen.Number of previous passwords to block. Gültige Werte: 0 bis 24.Valid values 0 to 24
passwordSignInFailureCountBeforeFactoryResetpasswordSignInFailureCountBeforeFactoryReset Int32Int32 Legt fest, nach wie vielen fehlgeschlagenen Anmeldeversuchen eine Zurücksetzung auf die Werkseinstellungen durchgeführt wird.Number of sign in failures allowed before factory reset. Gültige Werte 1 bis 16Valid values 1 to 16
passwordRequiredTypepasswordRequiredType androidRequiredPasswordTypeandroidRequiredPasswordType Geforderter Kennworttyp.Type of password that is required. Mögliche Werte: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.Possible values are: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordRequiredpasswordRequired Boolescher WertBoolean Gibt an, ob ein Kennwort erforderlich ist.Indicates whether or not to require a password.
powerOffBlockedpowerOffBlocked BooleschBoolean Gibt an, ob das Ausschalten des Geräts blockiert werden soll.Indicates whether or not to block powering off the device.
factoryResetBlockedfactoryResetBlocked BooleschBoolean Gibt an, ob verhindert werden soll, dass der Benutzer eine Zurücksetzung auf die Werkseinstellungen durchführt.Indicates whether or not to block user performing a factory reset.
screenCaptureBlockedscreenCaptureBlocked BooleschBoolean Gibt an, ob Screenshots blockiert werden sollen.Indicates whether or not to block screenshots.
deviceSharingAlloweddeviceSharingAllowed BooleschBoolean Gibt an, ob der Gerätefreigabemodus zugelassen wird.Indicates whether or not to allow device sharing mode.
storageBlockGoogleBackupstorageBlockGoogleBackup BooleschBoolean Gibt an, ob die Google-Sicherung blockiert werden soll.Indicates whether or not to block Google Backup.
storageBlockRemovableStoragestorageBlockRemovableStorage BooleschBoolean Gibt an, ob die Verwendung von Wechselmedien blockiert werden soll.Indicates whether or not to block removable storage usage.
storageRequireDeviceEncryptionstorageRequireDeviceEncryption BooleschBoolean Gibt an, ob eine Geräteverschlüsselung erforderlich ist.Indicates whether or not to require device encryption.
storageRequireRemovableStorageEncryptionstorageRequireRemovableStorageEncryption BooleschBoolean Gibt an, ob die Verschlüsselung von Wechselmedien erforderlich ist.Indicates whether or not to require removable storage encryption.
voiceAssistantBlockedvoiceAssistantBlocked BooleschBoolean Gibt an, ob die Verwendung des Sprach-Assistenten blockiert werden soll.Indicates whether or not to block the use of the Voice Assistant.
voiceDialingBlockedvoiceDialingBlocked Boolescher WertBoolean Gibt an, ob das Sprachwahlverfahren blockiert werden soll.Indicates whether or not to block voice dialing.
webBrowserBlockPopupswebBrowserBlockPopups BooleschBoolean Gibt an, ob Popups innerhalb des Webbrowsers blockiert werden sollen.Indicates whether or not to block popups within the web browser.
webBrowserBlockAutofillwebBrowserBlockAutofill BooleschBoolean Gibt an, ob das AutoAusfüllen-Feature des Webbrowsers blockiert werden soll.Indicates whether or not to block the web browser's auto fill feature.
webBrowserBlockJavaScriptwebBrowserBlockJavaScript BooleschBoolean Gibt an, ob JavaScript im Webbrowser blockiert werden soll.Indicates whether or not to block JavaScript within the web browser.
webBrowserBlockedwebBrowserBlocked BooleschBoolean Gibt an, ob der Webbrowser blockiert werden soll.Indicates whether or not to block the web browser.
webBrowserCookieSettingswebBrowserCookieSettings webBrowserCookieSettingswebBrowserCookieSettings Cookieeinstellungen des Webbrowsers.Cookie settings within the web browser. Mögliche Werte: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways.Possible values are: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways.
wiFiBlockedwiFiBlocked BooleanBoolean Gibt an, ob die WLAN-Synchronisierung blockiert werden soll.Indicates whether or not to block syncing Wi-Fi.
appsInstallAllowListappsInstallAllowList Collection von Objekten des Typs appListItemappListItem collection Liste von Apps, die auf dem KNOX-Gerät installiert werden dürfen.List of apps which can be installed on the KNOX device. Diese Sammlung darf maximal 500 Elemente enthalten.This collection can contain a maximum of 500 elements.
appsLaunchBlockListappsLaunchBlockList Collection von Objekten des Typs appListItemappListItem collection Liste von Apps, die auf dem KNOX-Gerät nicht gestartet werden dürfen.List of apps which are blocked from being launched on the KNOX device. Diese Sammlung darf maximal 500 Elemente enthalten.This collection can contain a maximum of 500 elements.
appsHideListappsHideList Collection von Objekten des Typs appListItemappListItem collection Liste von Apps, die auf dem KNOX-Gerät ausgeblendet werden sollen.List of apps to be hidden on the KNOX device. Diese Sammlung darf maximal 500 Elemente enthalten.This collection can contain a maximum of 500 elements.
securityRequireVerifyAppssecurityRequireVerifyApps Boolescher WertBoolean Legt fest, dass die Android-Funktion „Verify Apps“ aktiviert sein muss.Require the Android Verify apps feature is turned on.

AntwortResponse

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK und ein aktualisiertes Objekt des Typs androidGeneralDeviceConfiguration im Antworttext zurück.If successful, this method returns a 200 OK response code and an updated androidGeneralDeviceConfiguration object in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

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

AntwortResponse

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.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
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
}