创建 androidDeviceOwnerGeneralDeviceConfigurationCreate androidDeviceOwnerGeneralDeviceConfiguration

命名空间:microsoft.graphNamespace: microsoft.graph

重要说明:/Beta 版本下的 Microsoft Graph Api 可能会发生更改;不支持生产使用。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

注意: 适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

创建新的androidDeviceOwnerGeneralDeviceConfiguration对象。Create a new androidDeviceOwnerGeneralDeviceConfiguration object.

先决条件Prerequisites

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

权限类型Permission type 权限(从最高特权到最低特权)Permissions (from most to least privileged)
委派(工作或学校帐户)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
委派(个人 Microsoft 帐户)Delegated (personal Microsoft account) 不支持。Not supported.
应用程序Application DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

HTTP 请求HTTP Request

POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations

请求标头Request headers

标头Header Value
AuthorizationAuthorization Bearer <token>。必需。Bearer <token> Required.
接受Accept application/jsonapplication/json

请求正文Request body

在请求正文中,提供 androidDeviceOwnerGeneralDeviceConfiguration 对象的 JSON 表示形式。In the request body, supply a JSON representation for the androidDeviceOwnerGeneralDeviceConfiguration object.

下表显示创建 androidDeviceOwnerGeneralDeviceConfiguration 时所需的属性。The following table shows the properties that are required when you create the androidDeviceOwnerGeneralDeviceConfiguration.

属性Property 类型Type 说明Description
idid 字符串String 实体的键。Key of the entity. 继承自 deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 上次修改对象的日期/时间。DateTime the object was last modified. 继承自 deviceConfigurationInherited from deviceConfiguration
roleScopeTagIdsroleScopeTagIds String collectionString collection 此实体实例的范围标记列表。List of Scope Tags for this Entity instance. 继承自 deviceConfigurationInherited from deviceConfiguration
supportsScopeTagssupportsScopeTags BooleanBoolean 指示基础设备配置是否支持作用域标记的分配。Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. 如果此值为 false,则不允许分配给 ScopeTags 属性,并且实体将对作用域用户不可见。Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. 这适用于在 Silverlight 中创建的旧版策略,可以通过在 Azure 门户中删除并重新创建策略来解决此事件。This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. 此属性是只读的。This property is read-only. 继承自 deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition 适用于此策略的操作系统版本。The OS edition applicability for this Policy. 继承自 deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion 此策略的操作系统版本适用性规则。The OS version applicability rule for this Policy. 继承自 deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode 此策略的设备模式适用性规则。The device mode applicability rule for this Policy. 继承自 deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 创建对象的日期/时间。DateTime the object was created. 继承自 deviceConfigurationInherited from deviceConfiguration
说明description StringString 管理员提供的设备配置的说明。Admin provided description of the Device Configuration. 继承自 deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName StringString 管理员提供的设备配置的名称。Admin provided name of the device configuration. 继承自 deviceConfigurationInherited from deviceConfiguration
versionversion Int32Int32 设备配置的版本。Version of the device configuration. 继承自 deviceConfigurationInherited from deviceConfiguration
accountsBlockModificationaccountsBlockModification BooleanBoolean 指示是否禁用添加或删除帐户。Indicates whether or not adding or removing accounts is disabled.
appsAllowInstallFromUnknownSourcesappsAllowInstallFromUnknownSources BooleanBoolean 指示是否允许用户启用 "未知源" 设置。Indicates whether or not the user is allowed to enable to unknown sources setting.
appsAutoUpdatePolicyappsAutoUpdatePolicy androidDeviceOwnerAppAutoUpdatePolicyTypeandroidDeviceOwnerAppAutoUpdatePolicyType 指示应用程序自动更新策略的值。Indicates the value of the app auto update policy. 可取值为:notConfigureduserChoiceneverwiFiOnlyalwaysPossible values are: notConfigured, userChoice, never, wiFiOnly, always.
appsDefaultPermissionPolicyappsDefaultPermissionPolicy androidDeviceOwnerDefaultAppPermissionPolicyTypeandroidDeviceOwnerDefaultAppPermissionPolicyType 指示对运行时权限请求的权限策略(如果专门没有为应用程序定义)。Indicates the permission policy for requests for runtime permissions if one is not defined for the app specifically. 可取值为:deviceDefaultpromptautoGrantautoDenyPossible values are: deviceDefault, prompt, autoGrant, autoDeny.
appsRecommendSkippingFirstUseHintsappsRecommendSkippingFirstUseHints BooleanBoolean 是否建议所有应用都将跳过他们可能已添加的任何首次使用提示。Whether or not to recommend all apps skip any first-time-use hints they may have added.
bluetoothBlockConfigurationbluetoothBlockConfiguration BooleanBoolean 指示是否阻止用户配置蓝牙。Indicates whether or not to block a user from configuring bluetooth.
bluetoothBlockContactSharingbluetoothBlockContactSharing BooleanBoolean 指示是否阻止用户通过蓝牙共享联系人。Indicates whether or not to block a user from sharing contacts via bluetooth.
cameraBlockedcameraBlocked BooleanBoolean 指示是否禁用相机的使用。Indicates whether or not to disable the use of the camera.
cellularBlockWiFiTetheringcellularBlockWiFiTethering BooleanBoolean 指示是否阻止 Wi-Fi 网络共享。Indicates whether or not to block Wi-Fi tethering.
certificateCredentialConfigurationDisabledcertificateCredentialConfigurationDisabled BooleanBoolean 指示是否阻止来自任何证书凭据配置的用户。Indicates whether or not to block users from any certificate credential configuration.
microsoftLauncherConfigurationEnabledmicrosoftLauncherConfigurationEnabled BooleanBoolean 指示是否要配置 Microsoft 启动器。Indicates whether or not to you want configure Microsoft Launcher.
microsoftLauncherCustomWallpaperEnabledmicrosoftLauncherCustomWallpaperEnabled BooleanBoolean 指示是否在目标设备上配置墙纸。Indicates whether or not to configure the wallpaper on the targeted devices.
microsoftLauncherCustomWallpaperImageUrlmicrosoftLauncherCustomWallpaperImageUrl StringString 指示用作目标设备墙纸的图像文件的 URL。Indicates the URL for the image file to use as the wallpaper on the targeted devices.
microsoftLauncherCustomWallpaperAllowUserModificationmicrosoftLauncherCustomWallpaperAllowUserModification BooleanBoolean 指示用户是否可以修改墙纸以个性化设置其设备。Indicates whether or not the user can modify the wallpaper to personalize their device.
microsoftLauncherFeedEnabledmicrosoftLauncherFeedEnabled BooleanBoolean 指示是否要在设备上启用启动器源。Indicates whether or not you want to enable the launcher feed on the device.
microsoftLauncherFeedAllowUserModificationmicrosoftLauncherFeedAllowUserModification BooleanBoolean 指示用户是否可以修改设备上的启动器源。Indicates whether or not the user can modify the launcher feed on the device.
microsoftLauncherDockPresenceConfigurationmicrosoftLauncherDockPresenceConfiguration microsoftLauncherDockPresencemicrosoftLauncherDockPresence 指示是否要配置设备停靠。Indicates whether or not you want to configure the device dock. 可取值为:notConfiguredshowhidedisabledPossible values are: notConfigured, show, hide, disabled.
microsoftLauncherDockPresenceAllowUserModificationmicrosoftLauncherDockPresenceAllowUserModification BooleanBoolean 指示用户是否可以修改设备上的设备停靠配置。Indicates whether or not the user can modify the device dock configuration on the device.
microsoftLauncherSearchBarPlacementConfigurationmicrosoftLauncherSearchBarPlacementConfiguration microsoftLauncherSearchBarPlacementmicrosoftLauncherSearchBarPlacement 指示设备上的搜索栏的布局配置。Indicates the search bar placement configuration on the device. 可取值为:notConfiguredtopbottomhidePossible values are: notConfigured, top, bottom, hide.
enrollmentProfileenrollmentProfile androidDeviceOwnerEnrollmentProfileTypeandroidDeviceOwnerEnrollmentProfileType 指示要配置的注册配置文件。Indicates which enrollment profile you want to configure. 可取值为:notConfigureddedicatedDevicefullyManagedPossible values are: notConfigured, dedicatedDevice, fullyManaged.
dataRoamingBlockeddataRoamingBlocked BooleanBoolean 指示是否阻止用户使用数据漫游。Indicates whether or not to block a user from data roaming.
dateTimeConfigurationBlockeddateTimeConfigurationBlocked BooleanBoolean 指示是否阻止用户手动更改设备上的日期或时间Indicates whether or not to block the user from manually changing the date or time on the device
factoryResetDeviceAdministratorEmailsfactoryResetDeviceAdministratorEmails String collectionString collection 在设备出厂重置之前,将需要进行身份验证的 Google 帐户电子邮件的列表,然后才能对其进行设置。List of Google account emails that will be required to authenticate after a device is factory reset before it can be set up.
factoryResetBlockedfactoryResetBlocked BooleanBoolean 指示是否禁用了 "设置" 中的 "恢复出厂设置" 选项。Indicates whether or not the factory reset option in settings is disabled.
globalProxyglobalProxy androidDeviceOwnerGlobalProxyandroidDeviceOwnerGlobalProxy 代理是与主机、端口和已排除的主机直接建立的。Proxy is set up directly with host, port and excluded hosts.
googleAccountsBlockedgoogleAccountsBlocked BooleanBoolean 指示是否将阻止 google 帐户。Indicates whether or not google accounts will be blocked.
kioskModeScreenSaverConfigurationEnabledkioskModeScreenSaverConfigurationEnabled BooleanBoolean 是否启用屏幕保护程序模式或不启用展台模式。Whether or not to enable screen saver mode or not in Kiosk Mode.
kioskModeScreenSaverImageUrlkioskModeScreenSaverImageUrl StringString 将作为展台模式下设备的屏幕保护程序的图像的 URL。URL for an image that will be the device's screen saver in Kiosk Mode.
kioskModeScreenSaverDisplayTimeInSecondskioskModeScreenSaverDisplayTimeInSeconds Int32Int32 设备将在展台模式下显示屏幕保护程序的秒数。The number of seconds that the device will display the screen saver for in Kiosk Mode. 有效值为0至9999999Valid values 0 to 9999999
kioskModeScreenSaverStartDelayInSecondskioskModeScreenSaverStartDelayInSeconds Int32Int32 在 Kiosk 模式下显示屏幕保护程序之前设备需要保持非活动状态的秒数。The number of seconds the device needs to be inactive for before the screen saver is shown in Kiosk Mode. 有效值为1至9999999Valid values 1 to 9999999
kioskModeScreenSaverDetectMediaDisabledkioskModeScreenSaverDetectMediaDisabled BooleanBoolean 如果音频/视频在展台模式下播放,则设备屏幕是否应显示屏幕保护程序。Whether or not the device screen should show the screen saver if audio/video is playing in Kiosk Mode.
kioskModeAppskioskModeApps appListItem 集合appListItem collection 设备处于展台模式时将显示的托管应用列表。A list of managed apps that will be shown when the device is in Kiosk Mode. 该集合最多可包含 500 个元素。This collection can contain a maximum of 500 elements.
kioskModeWallpaperUrlkioskModeWallpaperUrl StringString 在设备处于展台模式时用于墙纸的可公开访问图像的 URL。URL to a publicly accessible image to use for the wallpaper when the device is in Kiosk Mode.
kioskModeExitCodekioskModeExitCode StringString 退出代码,以允许用户在设备处于展台模式时从展台模式中进行转义。Exit code to allow a user to escape from Kiosk Mode when the device is in Kiosk Mode.
kioskModeVirtualHomeButtonEnabledkioskModeVirtualHomeButtonEnabled BooleanBoolean 设备处于展台模式时是否显示虚拟 "主页" 按钮。Whether or not to display a virtual home button when the device is in Kiosk Mode.
kioskModeVirtualHomeButtonTypekioskModeVirtualHomeButtonType androidDeviceOwnerVirtualHomeButtonTypeandroidDeviceOwnerVirtualHomeButtonType 指示虚拟 home 按钮是否为向上轻扫主页按钮或浮动主页按钮。Indicates whether the virtual home button is a swipe up home button or a floating home button. 可取值为:notConfiguredswipeUpfloatingPossible values are: notConfigured, swipeUp, floating.
kioskModeBluetoothConfigurationEnabledkioskModeBluetoothConfigurationEnabled BooleanBoolean 是否允许用户在展台模式下配置蓝牙设置。Whether or not to allow a user to configure Bluetooth settings in Kiosk Mode.
kioskModeWiFiConfigurationEnabledkioskModeWiFiConfigurationEnabled BooleanBoolean 是否允许用户在展台模式下配置 Wi-fi 设置。Whether or not to allow a user to configure Wi-Fi settings in Kiosk Mode.
kioskModeFlashlightConfigurationEnabledkioskModeFlashlightConfigurationEnabled BooleanBoolean 是否允许用户在展台模式下使用该模式。Whether or not to allow a user to use the flashlight in Kiosk Mode.
kioskModeMediaVolumeConfigurationEnabledkioskModeMediaVolumeConfigurationEnabled BooleanBoolean 是否允许用户在展台模式下更改媒体音量。Whether or not to allow a user to change the media volume in Kiosk Mode.
kioskModeShowDeviceInfokioskModeShowDeviceInfo BooleanBoolean 是否允许用户访问基本设备信息。Whether or not to allow a user to access basic device information.
kioskModeManagedSettingsEntryDisabledkioskModeManagedSettingsEntryDisabled BooleanBoolean 是否在展台模式下在托管的主屏幕上显示托管设置入口点。Whether or not to display the Managed Settings entry point on the managed home screen in Kiosk Mode.
kioskModeDebugMenuEasyAccessEnabledkioskModeDebugMenuEasyAccessEnabled BooleanBoolean 是否允许用户在展台模式下轻松访问 "调试" 菜单。Whether or not to allow a user to easy access to the debug menu in Kiosk Mode.
kioskModeShowAppNotificationBadgekioskModeShowAppNotificationBadge BooleanBoolean 是否在展台模式下显示应用程序通知徽章。Whether or not to display application notification badges in Kiosk Mode.
kioskModeScreenOrientationkioskModeScreenOrientation androidDeviceOwnerKioskModeScreenOrientationandroidDeviceOwnerKioskModeScreenOrientation 在展台模式下管理的主屏幕的屏幕方向配置。Screen orientation configuration for managed home screen in Kiosk Mode. 可取值为:notConfiguredportraitlandscapeautoRotatePossible values are: notConfigured, portrait, landscape, autoRotate.
kioskModeIconSizekioskModeIconSize androidDeviceOwnerKioskModeIconSizeandroidDeviceOwnerKioskModeIconSize 在展台模式下,管理的主屏幕的图标大小配置。Icon size configuration for managed home screen in Kiosk Mode. 可取值为:notConfiguredsmallestsmallregularlargelargestPossible values are: notConfigured, smallest, small, regular, large, largest.
kioskModeFolderIconkioskModeFolderIcon androidDeviceOwnerKioskModeFolderIconandroidDeviceOwnerKioskModeFolderIcon 展台模式下的托管主屏幕的文件夹图标配置。Folder icon configuration for managed home screen in Kiosk Mode. 可取值为:notConfigureddarkSquaredarkCirclelightSquarelightCirclePossible values are: notConfigured, darkSquare, darkCircle, lightSquare, lightCircle.
kioskModeWifiAllowedSsidskioskModeWifiAllowedSsids String collectionString collection 可供用户在展台模式下进行配置的受限制的 WIFI Ssid 集。The restricted set of WIFI SSIDs available for the user to configure in Kiosk Mode. 该集合最多可包含 500 个元素。This collection can contain a maximum of 500 elements.
microphoneForceMutemicrophoneForceMute BooleanBoolean 指示是否阻止观众在设备上的麦克风。Indicates whether or not to block unmuting the microphone on the device.
networkEscapeHatchAllowednetworkEscapeHatchAllowed BooleanBoolean 指示在引导时设备是否允许连接到临时网络连接。Indicates whether or not the device will allow connecting to a temporary network connection at boot time.
nfcBlockOutgoingBeamnfcBlockOutgoingBeam BooleanBoolean 指示是否阻止 NFC 传出横梁。Indicates whether or not to block NFC outgoing beam.
passwordBlockKeyguardpasswordBlockKeyguard BooleanBoolean 指示是否禁用 keyguard。Indicates whether or not the keyguard is disabled.
passwordBlockKeyguardFeaturespasswordBlockKeyguardFeatures androidKeyguardFeature集合androidKeyguardFeature collection 要阻止的设备 keyguard 功能的列表。List of device keyguard features to block. 该集合最多可包含 7 个元素。This collection can contain a maximum of 7 elements. 可取值为:notConfiguredcameranotificationsunredactedNotificationstrustAgentsfingerprintremoteInputallFeaturesPossible values are: notConfigured, camera, notifications, unredactedNotifications, trustAgents, fingerprint, remoteInput, allFeatures.
passwordExpirationDayspasswordExpirationDays Int32Int32 指示在密码过期之前可以设置密码的时间量(以秒为单位)以及需要新密码的时间(以秒为单位)。Indicates the amount of time in seconds that a password can be set for before it expires and a new password will be required. 有效值为 1 至 365。Valid values 1 to 365
passwordMinimumLengthpasswordMinimumLength Int32Int32 指示设备上所需密码的最小长度。Indicates the minimum length of the password required on the device. 有效值为 4 至 16Valid values 4 to 16
passwordMinimumLetterCharacterspasswordMinimumLetterCharacters Int32Int32 指示设备密码所需的字母字符的最小数量。Indicates the minimum number of letter characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinimumLowerCaseCharacterspasswordMinimumLowerCaseCharacters Int32Int32 指示设备密码所需的最小小写字符数。Indicates the minimum number of lower case characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinimumNonLetterCharacterspasswordMinimumNonLetterCharacters Int32Int32 指示设备密码所需的最小非字母字符数。Indicates the minimum number of non-letter characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinimumNumericCharacterspasswordMinimumNumericCharacters Int32Int32 指示设备密码所需的最小数字字符数。Indicates the minimum number of numeric characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinimumSymbolCharacterspasswordMinimumSymbolCharacters Int32Int32 指示设备密码所需的最小符号字符数。Indicates the minimum number of symbol characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinimumUpperCaseCharacterspasswordMinimumUpperCaseCharacters Int32Int32 指示设备密码所需的最小上限 caseletter 字符数。Indicates the minimum number of upper caseletter characters required for device password. 有效值为1至16Valid values 1 to 16
passwordMinutesOfInactivityBeforeScreenTimeoutpasswordMinutesOfInactivityBeforeScreenTimeout Int32Int32 屏幕超时之前的不活动时间(毫秒)。Milliseconds of inactivity before the screen times out.
passwordPreviousPasswordCountToBlockpasswordPreviousPasswordCountToBlock Int32Int32 指示密码历史记录的长度,其中用户将不能输入与历史记录中的任何密码相同的新密码。Indicates the length of password history, where the user will not be able to enter a new password that is the same as any password in the history. 有效值为 0 至 24Valid values 0 to 24
passwordRequiredTypepasswordRequiredType androidDeviceOwnerRequiredPasswordTypeandroidDeviceOwnerRequiredPasswordType 指示设备上所需的最小密码质量。Indicates the minimum password quality required on the device. 可取值为:deviceDefaultrequirednumericnumericComplexalphabeticalphanumericalphanumericWithSymbolslowSecurityBiometriccustomPasswordPossible values are: deviceDefault, required, numeric, numericComplex, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, customPassword.
passwordSignInFailureCountBeforeFactoryResetpasswordSignInFailureCountBeforeFactoryReset Int32Int32 指示用户在擦除设备之前可以输入不正确密码的次数。Indicates the number of times a user can enter an incorrect password before the device is wiped. 有效值为 4 至 11Valid values 4 to 11
playStoreModeplayStoreMode androidDeviceOwnerPlayStoreModeandroidDeviceOwnerPlayStoreMode 指示设备的播放存储模式。Indicates the Play Store mode of the device. 可取值为:notConfiguredallowListblockListPossible values are: notConfigured, allowList, blockList.
safeBootBlockedsafeBootBlocked BooleanBoolean 指示是否禁用重新启动设备到安全启动。Indicates whether or not rebooting the device into safe boot is disabled.
screenCaptureBlockedscreenCaptureBlocked BooleanBoolean 指示是否禁用获取屏幕截图的功能。Indicates whether or not to disable the capability to take screenshots.
securityAllowDebuggingFeaturessecurityAllowDebuggingFeatures BooleanBoolean 指示是否阻止用户启用设备上的调试功能。Indicates whether or not to block the user from enabling debugging features on the device.
securityRequireVerifyAppssecurityRequireVerifyApps BooleanBoolean 指示是否需要验证应用。Indicates whether or not verify apps is required.
statusBarBlockedstatusBarBlocked BooleanBoolean 指示是否禁用状态栏,包括通知、快速设置和其他屏幕重叠。Indicates whether or the status bar is disabled, including notifications, quick settings and other screen overlays.
stayOnModesstayOnModes androidDeviceOwnerBatteryPluggedMode集合androidDeviceOwnerBatteryPluggedMode collection 设备的显示将保持开机状态的模式列表。List of modes in which the device's display will stay powered-on. 此集合最多可包含4个元素。This collection can contain a maximum of 4 elements. 可取值为:notConfiguredacusbwirelessPossible values are: notConfigured, ac, usb, wireless.
storageAllowUsbstorageAllowUsb BooleanBoolean 指示是否允许 USB 大容量存储。Indicates whether or not to allow USB mass storage.
storageBlockExternalMediastorageBlockExternalMedia BooleanBoolean 指示是否阻止外部媒体。Indicates whether or not to block external media.
storageBlockUsbFileTransferstorageBlockUsbFileTransfer BooleanBoolean 指示是否阻止 USB 文件传输。Indicates whether or not to block USB file transfer.
systemUpdateWindowStartMinutesAfterMidnightsystemUpdateWindowStartMinutesAfterMidnight Int32Int32 指示系统更新窗口午夜后启动的分钟数。Indicates the number of minutes after midnight that the system update window starts. 有效值为0至1440Valid values 0 to 1440
systemUpdateWindowEndMinutesAfterMidnightsystemUpdateWindowEndMinutesAfterMidnight Int32Int32 指示系统更新窗口结束后的分钟数。Indicates the number of minutes after midnight that the system update window ends. 有效值为0至1440Valid values 0 to 1440
systemUpdateInstallTypesystemUpdateInstallType androidDeviceOwnerSystemUpdateInstallTypeandroidDeviceOwnerSystemUpdateInstallType 系统更新配置的类型。The type of system update configuration. 可取值为:deviceDefaultpostponewindowedautomaticPossible values are: deviceDefault, postpone, windowed, automatic.
systemWindowsBlockedsystemWindowsBlocked BooleanBoolean 是否阻止 Android 系统提示符窗口,如 toast、电话活动和系统通知。Whether or not to block Android system prompt windows, like toasts, phone activities, and system alerts.
usersBlockAddusersBlockAdd BooleanBoolean 指示是否禁用添加用户和配置文件。Indicates whether or not adding users and profiles is disabled.
usersBlockRemoveusersBlockRemove BooleanBoolean 指示是否禁用从设备中删除其他用户。Indicates whether or not to disable removing other users from the device.
volumeBlockAdjustmentvolumeBlockAdjustment BooleanBoolean 指示是否禁用了调整主音量。Indicates whether or not adjusting the master volume is disabled.
vpnAlwaysOnLockdownModevpnAlwaysOnLockdownMode BooleanBoolean 如果指定了 always on VPN 包名称,则在断开 VPN 连接时是否锁定网络流量。If an always on VPN package name is specified, whether or not to lock network traffic when that VPN is disconnected.
vpnAlwaysOnPackageIdentifiervpnAlwaysOnPackageIdentifier StringString 将处理永不启用 VPN 连接的应用程序的 Android 应用程序包名称。Android app package name for app that will handle an always-on VPN connection.
wifiBlockEditConfigurationswifiBlockEditConfigurations BooleanBoolean 指示是否阻止用户编辑 wifi 连接设置。Indicates whether or not to block the user from editing the wifi connection settings.
wifiBlockEditPolicyDefinedConfigurationswifiBlockEditPolicyDefinedConfigurations BooleanBoolean 指示是否阻止用户仅编辑策略定义的网络。Indicates whether or not to block the user from editing just the networks defined by the policy.

响应Response

如果成功,此方法 201 Created 在响应正文中返回响应代码和androidDeviceOwnerGeneralDeviceConfiguration对象。If successful, this method returns a 201 Created response code and a androidDeviceOwnerGeneralDeviceConfiguration object in the response body.

示例Example

请求Request

下面是一个请求示例。Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 5359

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
  "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,
  "accountsBlockModification": true,
  "appsAllowInstallFromUnknownSources": true,
  "appsAutoUpdatePolicy": "userChoice",
  "appsDefaultPermissionPolicy": "prompt",
  "appsRecommendSkippingFirstUseHints": true,
  "bluetoothBlockConfiguration": true,
  "bluetoothBlockContactSharing": true,
  "cameraBlocked": true,
  "cellularBlockWiFiTethering": true,
  "certificateCredentialConfigurationDisabled": true,
  "microsoftLauncherConfigurationEnabled": true,
  "microsoftLauncherCustomWallpaperEnabled": true,
  "microsoftLauncherCustomWallpaperImageUrl": "https://example.com/microsoftLauncherCustomWallpaperImageUrl/",
  "microsoftLauncherCustomWallpaperAllowUserModification": true,
  "microsoftLauncherFeedEnabled": true,
  "microsoftLauncherFeedAllowUserModification": true,
  "microsoftLauncherDockPresenceConfiguration": "show",
  "microsoftLauncherDockPresenceAllowUserModification": true,
  "microsoftLauncherSearchBarPlacementConfiguration": "top",
  "enrollmentProfile": "dedicatedDevice",
  "dataRoamingBlocked": true,
  "dateTimeConfigurationBlocked": true,
  "factoryResetDeviceAdministratorEmails": [
    "Factory Reset Device Administrator Emails value"
  ],
  "factoryResetBlocked": true,
  "globalProxy": {
    "@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
    "proxyAutoConfigURL": "Proxy Auto Config URL value"
  },
  "googleAccountsBlocked": true,
  "kioskModeScreenSaverConfigurationEnabled": true,
  "kioskModeScreenSaverImageUrl": "https://example.com/kioskModeScreenSaverImageUrl/",
  "kioskModeScreenSaverDisplayTimeInSeconds": 8,
  "kioskModeScreenSaverStartDelayInSeconds": 7,
  "kioskModeScreenSaverDetectMediaDisabled": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "kioskModeWallpaperUrl": "https://example.com/kioskModeWallpaperUrl/",
  "kioskModeExitCode": "Kiosk Mode Exit Code value",
  "kioskModeVirtualHomeButtonEnabled": true,
  "kioskModeVirtualHomeButtonType": "swipeUp",
  "kioskModeBluetoothConfigurationEnabled": true,
  "kioskModeWiFiConfigurationEnabled": true,
  "kioskModeFlashlightConfigurationEnabled": true,
  "kioskModeMediaVolumeConfigurationEnabled": true,
  "kioskModeShowDeviceInfo": true,
  "kioskModeManagedSettingsEntryDisabled": true,
  "kioskModeDebugMenuEasyAccessEnabled": true,
  "kioskModeShowAppNotificationBadge": true,
  "kioskModeScreenOrientation": "portrait",
  "kioskModeIconSize": "smallest",
  "kioskModeFolderIcon": "darkSquare",
  "kioskModeWifiAllowedSsids": [
    "Kiosk Mode Wifi Allowed Ssids value"
  ],
  "microphoneForceMute": true,
  "networkEscapeHatchAllowed": true,
  "nfcBlockOutgoingBeam": true,
  "passwordBlockKeyguard": true,
  "passwordBlockKeyguardFeatures": [
    "camera"
  ],
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinimumLetterCharacters": 15,
  "passwordMinimumLowerCaseCharacters": 2,
  "passwordMinimumNonLetterCharacters": 2,
  "passwordMinimumNumericCharacters": 0,
  "passwordMinimumSymbolCharacters": 15,
  "passwordMinimumUpperCaseCharacters": 2,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordCountToBlock": 4,
  "passwordRequiredType": "required",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "playStoreMode": "allowList",
  "safeBootBlocked": true,
  "screenCaptureBlocked": true,
  "securityAllowDebuggingFeatures": true,
  "securityRequireVerifyApps": true,
  "statusBarBlocked": true,
  "stayOnModes": [
    "ac"
  ],
  "storageAllowUsb": true,
  "storageBlockExternalMedia": true,
  "storageBlockUsbFileTransfer": true,
  "systemUpdateWindowStartMinutesAfterMidnight": 11,
  "systemUpdateWindowEndMinutesAfterMidnight": 9,
  "systemUpdateInstallType": "postpone",
  "systemWindowsBlocked": true,
  "usersBlockAdd": true,
  "usersBlockRemove": true,
  "volumeBlockAdjustment": true,
  "vpnAlwaysOnLockdownMode": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "wifiBlockEditConfigurations": true,
  "wifiBlockEditPolicyDefinedConfigurations": true
}

响应Response

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。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 201 Created
Content-Type: application/json
Content-Length: 5531

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
  "id": "edad943d-943d-edad-3d94-aded3d94aded",
  "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,
  "accountsBlockModification": true,
  "appsAllowInstallFromUnknownSources": true,
  "appsAutoUpdatePolicy": "userChoice",
  "appsDefaultPermissionPolicy": "prompt",
  "appsRecommendSkippingFirstUseHints": true,
  "bluetoothBlockConfiguration": true,
  "bluetoothBlockContactSharing": true,
  "cameraBlocked": true,
  "cellularBlockWiFiTethering": true,
  "certificateCredentialConfigurationDisabled": true,
  "microsoftLauncherConfigurationEnabled": true,
  "microsoftLauncherCustomWallpaperEnabled": true,
  "microsoftLauncherCustomWallpaperImageUrl": "https://example.com/microsoftLauncherCustomWallpaperImageUrl/",
  "microsoftLauncherCustomWallpaperAllowUserModification": true,
  "microsoftLauncherFeedEnabled": true,
  "microsoftLauncherFeedAllowUserModification": true,
  "microsoftLauncherDockPresenceConfiguration": "show",
  "microsoftLauncherDockPresenceAllowUserModification": true,
  "microsoftLauncherSearchBarPlacementConfiguration": "top",
  "enrollmentProfile": "dedicatedDevice",
  "dataRoamingBlocked": true,
  "dateTimeConfigurationBlocked": true,
  "factoryResetDeviceAdministratorEmails": [
    "Factory Reset Device Administrator Emails value"
  ],
  "factoryResetBlocked": true,
  "globalProxy": {
    "@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
    "proxyAutoConfigURL": "Proxy Auto Config URL value"
  },
  "googleAccountsBlocked": true,
  "kioskModeScreenSaverConfigurationEnabled": true,
  "kioskModeScreenSaverImageUrl": "https://example.com/kioskModeScreenSaverImageUrl/",
  "kioskModeScreenSaverDisplayTimeInSeconds": 8,
  "kioskModeScreenSaverStartDelayInSeconds": 7,
  "kioskModeScreenSaverDetectMediaDisabled": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "kioskModeWallpaperUrl": "https://example.com/kioskModeWallpaperUrl/",
  "kioskModeExitCode": "Kiosk Mode Exit Code value",
  "kioskModeVirtualHomeButtonEnabled": true,
  "kioskModeVirtualHomeButtonType": "swipeUp",
  "kioskModeBluetoothConfigurationEnabled": true,
  "kioskModeWiFiConfigurationEnabled": true,
  "kioskModeFlashlightConfigurationEnabled": true,
  "kioskModeMediaVolumeConfigurationEnabled": true,
  "kioskModeShowDeviceInfo": true,
  "kioskModeManagedSettingsEntryDisabled": true,
  "kioskModeDebugMenuEasyAccessEnabled": true,
  "kioskModeShowAppNotificationBadge": true,
  "kioskModeScreenOrientation": "portrait",
  "kioskModeIconSize": "smallest",
  "kioskModeFolderIcon": "darkSquare",
  "kioskModeWifiAllowedSsids": [
    "Kiosk Mode Wifi Allowed Ssids value"
  ],
  "microphoneForceMute": true,
  "networkEscapeHatchAllowed": true,
  "nfcBlockOutgoingBeam": true,
  "passwordBlockKeyguard": true,
  "passwordBlockKeyguardFeatures": [
    "camera"
  ],
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinimumLetterCharacters": 15,
  "passwordMinimumLowerCaseCharacters": 2,
  "passwordMinimumNonLetterCharacters": 2,
  "passwordMinimumNumericCharacters": 0,
  "passwordMinimumSymbolCharacters": 15,
  "passwordMinimumUpperCaseCharacters": 2,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordCountToBlock": 4,
  "passwordRequiredType": "required",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "playStoreMode": "allowList",
  "safeBootBlocked": true,
  "screenCaptureBlocked": true,
  "securityAllowDebuggingFeatures": true,
  "securityRequireVerifyApps": true,
  "statusBarBlocked": true,
  "stayOnModes": [
    "ac"
  ],
  "storageAllowUsb": true,
  "storageBlockExternalMedia": true,
  "storageBlockUsbFileTransfer": true,
  "systemUpdateWindowStartMinutesAfterMidnight": 11,
  "systemUpdateWindowEndMinutesAfterMidnight": 9,
  "systemUpdateInstallType": "postpone",
  "systemWindowsBlocked": true,
  "usersBlockAdd": true,
  "usersBlockRemove": true,
  "volumeBlockAdjustment": true,
  "vpnAlwaysOnLockdownMode": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "wifiBlockEditConfigurations": true,
  "wifiBlockEditPolicyDefinedConfigurations": true
}