创建 androidDeviceOwnerGeneralDeviceConfiguration
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
创建新的 androidDeviceOwnerGeneralDeviceConfiguration 对象。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 | 权限（从最低特权到最高特权） |
|---|---|
| 委派（工作或学校帐户） | DeviceManagementConfiguration.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 |
| 应用程序 | DeviceManagementConfiguration.ReadWrite.All |
HTTP 请求
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 androidDeviceOwnerGeneralDeviceConfiguration 对象的 JSON 表示形式。
下表显示了创建 androidDeviceOwnerGeneralDeviceConfiguration 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 实体的键。 继承自 deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | 上次修改对象的日期/时间。 继承自 deviceConfiguration |
| roleScopeTagIds | 字符串集合 | 此实体实例的范围标记列表。 继承自 deviceConfiguration |
| supportsScopeTags | 布尔值 | 指示基础设备配置是否支持分配范围标记。 如果此值为 false，并且实体对限定范围的用户不可见，则不允许向 ScopeTags 属性分配。 这发生在 Silverlight 中创建的旧策略，可以通过在 Azure 门户中删除并重新创建策略来解决。 此属性是只读的。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | 此策略的 OS 版本适用性。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | 此策略的 OS 版本适用性规则。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | 此策略的设备模式适用性规则。 继承自 deviceConfiguration |
| createdDateTime | DateTimeOffset | 创建对象的日期/时间。 继承自 deviceConfiguration |
| description | String | 管理员提供的设备配置的说明。 继承自 deviceConfiguration |
| displayName | String | 管理员提供的设备配置的名称。 继承自 deviceConfiguration |
| version | Int32 | 设备配置的版本。 继承自 deviceConfiguration |
| azureAdSharedDeviceDataClearApps | appListItem 集合 | 托管应用列表，这些应用将在 AAD 共享设备模式下全局注销期间清除其数据。 该集合最多可包含 500 个元素。 |
| accountsBlockModification | 布尔值 | 指示是否禁用添加或删除帐户。 |
| appsAllowInstallFromUnknownSources | 布尔值 | 指示是否允许用户启用未知源设置。 |
| appsAutoUpdatePolicy | androidDeviceOwnerAppAutoUpdatePolicyType | 指示应用自动更新策略的值。 可取值为：notConfigured、userChoice、never、wiFiOnly、always。 |
| appsDefaultPermissionPolicy | androidDeviceOwnerDefaultAppPermissionPolicyType | 指示运行时权限请求的权限策略（如果未专门为应用定义）。 可能的值是：deviceDefault、prompt、autoGrant、autoDeny。 |
| appsRecommendSkippingFirstUseHints | 布尔值 | 是否推荐所有应用都跳过它们可能已添加的任何首次使用提示。 |
| bluetoothBlockConfiguration | 布尔值 | 指示是否阻止用户配置蓝牙。 |
| bluetoothBlockContactSharing | 布尔值 | 指示是否阻止用户通过蓝牙共享联系人。 |
| cameraBlocked | 布尔值 | 指示是否禁用相机的使用。 |
| cellularBlockWiFiTethering | Boolean | 指示是否阻止 Wi-Fi 网络共享。 |
| certificateCredentialConfigurationDisabled | 布尔值 | 指示是否阻止用户进行任何证书凭据配置。 |
| crossProfilePoliciesAllowCopyPaste | 布尔值 | 指示是否可将从一个配置文件复制的文本 (个人或工作) 粘贴到另一个配置文件中。 |
| crossProfilePoliciesAllowDataSharing | androidDeviceOwnerCrossProfileDataSharing | 指示一个配置文件中的数据 (个人或工作) 是否可以与另一个配置文件中的应用共享。 可取值为：notConfigured、crossProfileDataSharingBlocked、dataSharingFromWorkToPersonalBlocked、crossProfileDataSharingAllowed、unkownFutureValue。 |
| crossProfilePoliciesShowWorkContactsInPersonalProfile | 布尔值 | 指示存储在工作配置文件中的联系人是否显示在个人个人资料联系人搜索/传入呼叫中。 |
| microsoftLauncherConfigurationEnabled | 布尔值 | 指示是否要配置 Microsoft Launcher。 |
| microsoftLauncherCustomWallpaperEnabled | 布尔值 | 指示是否在目标设备上配置壁纸。 |
| microsoftLauncherCustomWallpaperImageUrl | String | 指示图像文件在目标设备上用作壁纸的 URL。 |
| microsoftLauncherCustomWallpaperAllowUserModification | 布尔值 | 指示用户是否可以修改壁纸来个性化其设备。 |
| microsoftLauncherFeedEnabled | 布尔值 | 指示是否要在设备上启用启动器源。 |
| microsoftLauncherFeedAllowUserModification | 布尔值 | 指示用户是否可以修改设备上的启动器源。 |
| microsoftLauncherDockPresenceConfiguration | microsoftLauncherDockPresence | 指示是否要配置设备扩展坞。 可能的值是：notConfigured、show、hide、disabled。 |
| microsoftLauncherDockPresenceAllowUserModification | 布尔值 | 指示用户是否可以修改设备上的设备停靠配置。 |
| microsoftLauncherSearchBarPlacementConfiguration | microsoftLauncherSearchBarPlacement | 指示设备上的搜索栏放置配置。 可能的值是：notConfigured、top、bottom、hide。 |
| enrollmentProfile | androidDeviceOwnerEnrollmentProfileType | 指示要配置哪个注册配置文件。 可取值为：notConfigured、dedicatedDevice、fullyManaged。 |
| dataRoamingBlocked | 布尔值 | 指示是否阻止用户进行数据漫游。 |
| dateTimeConfigurationBlocked | 布尔值 | 指示是否阻止用户手动更改设备上的日期或时间 |
| detailedHelpText | androidDeviceOwnerUserFacingMessage | 表示当用户尝试修改其设备上的托管设置时向用户提供的自定义详细帮助文本。 |
| deviceOwnerLockScreenMessage | androidDeviceOwnerUserFacingMessage | 表示当用户尝试修改其设备上的托管设置时提供给用户的自定义锁屏消息。 |
| securityCommonCriteriaModeEnabled | 布尔值 | 表示当用户尝试修改其设备上的托管设置时提供给用户的安全通用条件模式。 |
| factoryResetDeviceAdministratorEmails | 字符串集合 | 在设备恢复出厂设置之前需要进行身份验证的 Google 帐户电子邮件列表。 |
| factoryResetBlocked | 布尔值 | 指示是否禁用设置中的恢复出厂设置选项。 |
| globalProxy | androidDeviceOwnerGlobalProxy | 使用主机、端口和排除的主机直接设置代理。 |
| googleAccountsBlocked | 布尔值 | 指示是否阻止 google 帐户。 |
| kioskCustomizationDeviceSettingsBlocked | 布尔值 | 指示用户在展台模式下是否可以访问设备的“设置”应用。 |
| kioskCustomizationPowerButtonActionsBlocked | 布尔值 | 当用户在展台模式下长按设备的电源按钮时是否显示电源菜单。 |
| kioskCustomizationStatusBar | androidDeviceOwnerKioskCustomizationStatusBar | 指示是否在展台模式下禁用系统信息和通知。 可取值为：notConfigured、notificationsAndSystemInfoEnabled、systemInfoOnly。 |
| kioskCustomizationSystemErrorWarnings | 布尔值 | 指示在展台模式下是否显示崩溃或无响应应用的系统错误对话框。 |
| kioskCustomizationSystemNavigation | androidDeviceOwnerKioskCustomizationSystemNavigation | 指示在展台模式下启用哪些导航功能。 可取值为：notConfigured、navigationEnabled、homeButtonOnly。 |
| kioskModeScreenSaverConfigurationEnabled | 布尔值 | 是否在展台模式下启用屏幕保护模式。 |
| kioskModeScreenSaverImageUrl | String | 将在展台模式下成为设备屏幕保护程序的图像的 URL。 |
| kioskModeScreenSaverDisplayTimeInSeconds | Int32 | 设备将在展台模式下显示屏幕保护的秒数。 有效值 0 到 9999999 |
| kioskModeScreenSaverStartDelayInSeconds | Int32 | 在展台模式下显示屏幕保护程序之前，设备需要处于非活动状态的秒数。 有效值 1 到 9999999 |
| kioskModeScreenSaverDetectMediaDisabled | 布尔值 | 如果音频/视频正在展台模式下播放，设备屏幕是否应显示屏幕保护程序。 |
| kioskModeApps | appListItem 集合 | 设备处于展台模式时显示的托管应用列表。 该集合最多可包含 500 个元素。 |
| kioskModeWallpaperUrl | String | 设备处于展台模式时用于壁纸的可公开访问图像的 URL。 |
| kioskModeExitCode | String | 退出代码，允许用户在设备处于展台模式时从展台模式中转义。 |
| kioskModeVirtualHomeButtonEnabled | 布尔值 | 设备处于展台模式时是否显示虚拟主页按钮。 |
| kioskModeVirtualHomeButtonType | androidDeviceOwnerVirtualHomeButtonType | 指示虚拟主页按钮是向上轻扫主页按钮还是浮动主页按钮。 可取值为：notConfigured、swipeUp、floating。 |
| kioskModeBluetoothConfigurationEnabled | 布尔值 | 是否允许用户在展台模式下配置蓝牙设置。 |
| kioskModeWiFiConfigurationEnabled | 布尔值 | 是否允许用户在展台模式下配置 Wi-Fi 设置。 |
| kioskModeFlashlightConfigurationEnabled | 布尔值 | 是否允许用户在展台模式下使用手电筒。 |
| kioskModeMediaVolumeConfigurationEnabled | 布尔值 | 是否允许用户在展台模式下更改媒体音量。 |
| kioskModeShowDeviceInfo | 布尔值 | 是否允许用户访问基本设备信息。 |
| kioskModeManagedSettingsEntryDisabled | 布尔值 | 是否在展台模式下在托管主屏幕上显示托管设置入口点。 |
| kioskModeDebugMenuEasyAccessEnabled | 布尔值 | 是否允许用户在展台模式下轻松访问调试菜单。 |
| kioskModeShowAppNotificationBadge | 布尔值 | 是否在展台模式下显示应用程序通知锁屏提醒。 |
| kioskModeScreenOrientation | androidDeviceOwnerKioskModeScreenOrientation | 展台模式下托管主屏幕的屏幕方向配置。 可能的值是：notConfigured、portrait、landscape、autoRotate。 |
| kioskModeIconSize | androidDeviceOwnerKioskModeIconSize | 展台模式下托管主屏幕的图标大小配置。 可取值为：notConfigured、smallest、small、regular、large、largest。 |
| kioskModeFolderIcon | androidDeviceOwnerKioskModeFolderIcon | 展台模式下托管主屏幕的文件夹图标配置。 可取值为：notConfigured、darkSquare、darkCircle、lightSquare、lightCircle。 |
| kioskModeWifiAllowedSsids | 字符串集合 | 允许用户在展台模式下配置的受限 WIFI SSD 集。 该集合最多可包含 500 个元素。 |
| kioskModeAppOrderEnabled | 布尔值 | 是否在展台模式下启用应用排序。 |
| kioskModeAppsInFolderOrderedByName | 布尔值 | 是否在展台模式下对文件夹中的应用程序按字母顺序排列。 |
| kioskModeGridHeight | Int32 | 在展台模式下启用应用排序的托管主屏幕网格的行数。 有效值 1 到 9999999 |
| kioskModeGridWidth | Int32 | 在展台模式下启用应用排序的托管主屏幕网格的列数。 有效值 1 到 9999999 |
| kioskModeLockHomeScreen | 布尔值 | 是否在展台模式下将主屏幕锁定给最终用户。 |
| kioskModeManagedFolders | androidDeviceOwnerKioskModeManagedFolder 集合 | 展台模式下设备的托管文件夹列表。 该集合最多可包含 500 个元素。 |
| kioskModeAppPositions | androidDeviceOwnerKioskModeAppPositionItem 集合 | 展台模式下的项排序托管主屏幕。 该集合最多可包含 500 个元素。 |
| kioskModeManagedHomeScreenAutoSignout | 布尔值 | 是否在非活动状态后自动注销 MHS 和共享设备模式应用程序，以便托管主屏幕。 |
| kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds | Int32 | 在自动注销用户进行托管主屏幕之前向用户发出通知的秒数。 有效值 0 到 9999999 |
| kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds | Int32 | 在自动注销用户进行托管主屏幕之前，设备处于非活动状态的秒数。 有效值 0 到 9999999 |
| kioskModeManagedHomeScreenPinComplexity | kioskModeManagedHomeScreenPinComplexity | 托管主屏幕登录会话的 PIN 的复杂性。 可取值为：notConfigured、simple、complex。 |
| kioskModeManagedHomeScreenPinRequired | 布尔值 | 是否要求用户为托管主屏幕的登录会话设置 PIN。 |
| kioskModeManagedHomeScreenPinRequiredToResume | 布尔值 | 如果为托管主屏幕显示屏幕保护程序，是否需要用户输入会话 PIN。 |
| kioskModeManagedHomeScreenSignInBackground | String | 托管主屏幕登录屏幕的自定义 URL 背景。 |
| kioskModeManagedHomeScreenSignInBrandingLogo | String | 托管主屏幕的登录屏幕和会话 PIN 页的自定义 URL 品牌徽标。 |
| kioskModeManagedHomeScreenSignInEnabled | 布尔值 | 是否显示托管主屏幕的登录屏幕。 |
| kioskModeUseManagedHomeScreenApp | kioskModeType | 是否使用单应用展台模式还是多应用展台模式。 可取值为：notConfigured、singleAppMode、multiAppMode。 |
| microphoneForceMute | 布尔值 | 指示是否阻止取消设备上的麦克风静音。 |
| networkEscapeHatchAllowed | 布尔值 | 指示设备是否允许在启动时连接到临时网络连接。 |
| nfcBlockOutgoingBeam | 布尔值 | 指示是否阻止 NFC 传出光束。 |
| passwordBlockKeyguard | 布尔值 | 指示密钥护卫是否处于禁用状态。 |
| passwordBlockKeyguardFeatures | androidKeyguardFeature 集合 | 要阻止的设备密钥护卫功能列表。 此集合最多可以包含 11 个元素。 可取值为：notConfigured、camera、notifications、unredactedNotifications、trustAgents、fingerprint、remoteInput、allFeatures、face、iris、biometrics。 |
| passwordExpirationDays | Int32 | 指示密码在过期之前可以设置的时间量，并且需要新密码。 有效值为 1 至 365。 |
| passwordMinimumLength | Int32 | 指示设备上所需的密码的最小长度。 有效值为 4 至 16 |
| passwordMinimumLetterCharacters | Int32 | 指示设备密码所需的最小字母字符数。 有效值 1 到 16 |
| passwordMinimumLowerCaseCharacters | Int32 | 指示设备密码所需的最小小写字符数。 有效值 1 到 16 |
| passwordMinimumNonLetterCharacters | Int32 | 指示设备密码所需的最小非字母字符数。 有效值 1 到 16 |
| passwordMinimumNumericCharacters | Int32 | 指示设备密码所需的最小数字字符数。 有效值 1 到 16 |
| passwordMinimumSymbolCharacters | Int32 | 指示设备密码所需的最小符号字符数。 有效值 1 到 16 |
| passwordMinimumUpperCaseCharacters | Int32 | 指示设备密码所需的最小大写字母字符数。 有效值 1 到 16 |
| passwordMinutesOfInactivityBeforeScreenTimeout | Int32 | 屏幕超时之前的不活动分钟数。 |
| passwordPreviousPasswordCountToBlock | Int32 | 指示密码历史记录的长度，用户将无法输入与历史记录中的任何密码相同的新密码。 有效值为 0 至 24 |
| passwordRequiredType | androidDeviceOwnerRequiredPasswordType | 指示设备上所需的最低密码质量。 可取值为：deviceDefault、required、numeric、numericComplex、alphabetic、alphanumeric、alphanumericWithSymbols、lowSecurityBiometric、customPassword。 |
| passwordRequireUnlock | androidDeviceOwnerRequiredPasswordUnlock | 指示必须使用强身份验证形式解锁设备的超时期限。 可取值为：deviceDefault、daily、unkownFutureValue。 |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | 指示用户在擦除设备之前输入错误密码的次数。 有效值为 4 至 11 |
| playStoreMode | androidDeviceOwnerPlayStoreMode | 指示设备的 Play Store 模式。 可取值为：notConfigured、allowList、blockList。 |
| screenCaptureBlocked | 布尔值 | 指示是否禁用屏幕截图功能。 |
| securityDeveloperSettingsEnabled | 布尔值 | 指示是否允许用户访问开发人员设置，例如设备上的开发人员选项和安全启动。 |
| securityRequireVerifyApps | 布尔值 | 指示是否需要验证应用。 |
| shortHelpText | androidDeviceOwnerUserFacingMessage | 表示当用户尝试修改其设备上的托管设置时提供给用户的自定义简短帮助文本。 |
| statusBarBlocked | 布尔值 | 指示状态栏是否被禁用，包括通知、快速设置和其他屏幕覆盖。 |
| stayOnModes | androidDeviceOwnerBatteryPluggedMode 集合 | 设备显示器将保持开机状态的模式列表。 此集合最多可以包含 4 个元素。 可能的值是：notConfigured、ac、usb、wireless。 |
| storageAllowUsb | 布尔值 | 指示是否允许 USB 大容量存储。 |
| storageBlockExternalMedia | 布尔值 | 指示是否阻止外部媒体。 |
| storageBlockUsbFileTransfer | 布尔值 | 指示是否阻止 USB 文件传输。 |
| systemUpdateFreezePeriods | androidDeviceOwnerSystemUpdateFreezePeriod 集合 | 指示系统更新推迟的年度重复时间段。 该集合最多可包含 500 个元素。 |
| systemUpdateWindowStartMinutesAfterMidnight | Int32 | 指示系统更新窗口在午夜后启动的分钟数。 有效值 0 到 1440 |
| systemUpdateWindowEndMinutesAfterMidnight | Int32 | 指示系统更新窗口在午夜后结束的分钟数。 有效值 0 到 1440 |
| systemUpdateInstallType | androidDeviceOwnerSystemUpdateInstallType | 系统更新配置的类型。 可能的值是：deviceDefault、postpone、windowed、automatic。 |
| systemWindowsBlocked | 布尔值 | 是否阻止 Android 系统提示窗口，例如 Toast、电话活动和系统警报。 |
| usersBlockAdd | 布尔值 | 指示是否禁用添加用户和配置文件。 |
| usersBlockRemove | 布尔值 | 指示是否禁用从设备中删除其他用户。 |
| volumeBlockAdjustment | 布尔值 | 指示是否禁用调整主卷。 |
| vpnAlwaysOnLockdownMode | 布尔值 | 如果指定了始终在 VPN 包名称上，则是否在该 VPN 断开连接时锁定网络流量。 |
| vpnAlwaysOnPackageIdentifier | String | 将处理始终启用 VPN 连接的应用的 Android 应用包名称。 |
| wifiBlockEditConfigurations | 布尔值 | 指示是否阻止用户编辑 wifi 连接设置。 |
| wifiBlockEditPolicyDefinedConfigurations | 布尔值 | 指示是否阻止用户仅编辑策略定义的网络。 |
| personalProfileAppsAllowInstallFromUnknownSources | 布尔值 | 指示用户是否可以在个人配置文件上安装来自未知源的应用。 |
| personalProfileCameraBlocked | 布尔值 | 指示是否禁用对个人配置文件使用相机。 |
| personalProfileScreenCaptureBlocked | 布尔值 | 指示是否禁用在个人配置文件上拍摄屏幕截图的功能。 |
| personalProfilePlayStoreMode | personalProfilePersonalPlayStoreMode | 与 PersonalProfilePersonalApplications 一起使用，可控制如何允许或阻止个人配置文件中的应用。 可取值为：notConfigured、blockedApps、allowedApps。 |
| personalProfilePersonalApplications | appListItem 集合 | 策略应用于个人配置文件中的应用程序。 该集合最多可包含 500 个元素。 |
| workProfilePasswordExpirationDays | Int32 | 指示工作配置文件密码在过期之前可以设置的天数，并且需要新密码。 有效值为 1 至 365。 |
| workProfilePasswordMinimumLength | Int32 | 指示工作配置文件密码的最小长度。 有效值为 4 至 16 |
| workProfilePasswordMinimumNumericCharacters | Int32 | 指示工作配置文件密码所需的最小数字字符数。 有效值 1 到 16 |
| workProfilePasswordMinimumNonLetterCharacters | Int32 | 指示工作配置文件密码所需的最小非字母字符数。 有效值 1 到 16 |
| workProfilePasswordMinimumLetterCharacters | Int32 | 指示工作配置文件密码所需的最小字母字符数。 有效值 1 到 16 |
| workProfilePasswordMinimumLowerCaseCharacters | Int32 | 指示工作配置文件密码所需的最小小写字符数。 有效值 1 到 16 |
| workProfilePasswordMinimumUpperCaseCharacters | Int32 | 指示工作配置文件密码所需的最小大写字母字符数。 有效值 1 到 16 |
| workProfilePasswordMinimumSymbolCharacters | Int32 | 指示工作配置文件密码所需的最小符号字符数。 有效值 1 到 16 |
| workProfilePasswordPreviousPasswordCountToBlock | Int32 | 指示工作配置文件密码历史记录的长度，用户将无法输入与历史记录中的任何密码相同的新密码。 有效值为 0 至 24 |
| workProfilePasswordSignInFailureCountBeforeFactoryReset | Int32 | 指示用户在擦除设备之前输入不正确的工作配置文件密码的次数。 有效值为 4 至 11 |
| workProfilePasswordRequiredType | androidDeviceOwnerRequiredPasswordType | 指示工作配置文件密码所需的最低密码质量。 可取值为：deviceDefault、required、numeric、numericComplex、alphabetic、alphanumeric、alphanumericWithSymbols、lowSecurityBiometric、customPassword。 |
| workProfilePasswordRequireUnlock | androidDeviceOwnerRequiredPasswordUnlock | 指示必须使用强身份验证形式解锁工作配置文件的超时期限。 可取值为：deviceDefault、daily、unkownFutureValue。 |
| locateDeviceUserlessDisabled | 布尔值 | 指示是否禁用适用于无用户 (COSU) 设备的 LocateDevice。 |
| locateDeviceLostModeEnabled | 布尔值 | 指示是否为丢失模式 (COBO、COPE) 的设备启用 LocateDevice。 |
| androidDeviceOwnerDelegatedScopeAppSettings | androidDeviceOwnerDelegatedScopeAppSetting 集合 | 指定托管应用的列表，其中包含应用详细信息及其关联的委托范围 () 。 该集合最多可包含 500 个元素。 |
| shareDeviceLocationDisabled | 布尔值 | 指示是否对完全托管的设备禁用位置共享 (COBO) ，以及具有工作配置文件的公司自有设备是否禁用位置共享 (COPE) |
| deviceLocationMode | androidDeviceOwnerLocationMode | 指示完全托管设备的位置设置配置 (COBO) ，以及具有工作配置文件的公司拥有的设备 (COPE) 。 可取值为：notConfigured、disabled、unknownFutureValue。 |
响应
如果成功，此方法在 201 Created 响应正文中返回响应代码和 androidDeviceOwnerGeneralDeviceConfiguration 对象。
示例
请求
下面是一个请求示例。
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 10717
{
"@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,
"azureAdSharedDeviceDataClearApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"accountsBlockModification": true,
"appsAllowInstallFromUnknownSources": true,
"appsAutoUpdatePolicy": "userChoice",
"appsDefaultPermissionPolicy": "prompt",
"appsRecommendSkippingFirstUseHints": true,
"bluetoothBlockConfiguration": true,
"bluetoothBlockContactSharing": true,
"cameraBlocked": true,
"cellularBlockWiFiTethering": true,
"certificateCredentialConfigurationDisabled": true,
"crossProfilePoliciesAllowCopyPaste": true,
"crossProfilePoliciesAllowDataSharing": "crossProfileDataSharingBlocked",
"crossProfilePoliciesShowWorkContactsInPersonalProfile": 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,
"detailedHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"deviceOwnerLockScreenMessage": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"securityCommonCriteriaModeEnabled": true,
"factoryResetDeviceAdministratorEmails": [
"Factory Reset Device Administrator Emails value"
],
"factoryResetBlocked": true,
"globalProxy": {
"@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
"proxyAutoConfigURL": "Proxy Auto Config URL value"
},
"googleAccountsBlocked": true,
"kioskCustomizationDeviceSettingsBlocked": true,
"kioskCustomizationPowerButtonActionsBlocked": true,
"kioskCustomizationStatusBar": "notificationsAndSystemInfoEnabled",
"kioskCustomizationSystemErrorWarnings": true,
"kioskCustomizationSystemNavigation": "navigationEnabled",
"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"
],
"kioskModeAppOrderEnabled": true,
"kioskModeAppsInFolderOrderedByName": true,
"kioskModeGridHeight": 3,
"kioskModeGridWidth": 2,
"kioskModeLockHomeScreen": true,
"kioskModeManagedFolders": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeManagedFolder",
"folderName": "Folder Name value",
"folderIdentifier": "Folder Identifier value",
"items": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
]
}
],
"kioskModeAppPositions": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeAppPositionItem",
"position": 8,
"item": {
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
}
],
"kioskModeManagedHomeScreenAutoSignout": true,
"kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds": 7,
"kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds": 8,
"kioskModeManagedHomeScreenPinComplexity": "simple",
"kioskModeManagedHomeScreenPinRequired": true,
"kioskModeManagedHomeScreenPinRequiredToResume": true,
"kioskModeManagedHomeScreenSignInBackground": "Kiosk Mode Managed Home Screen Sign In Background value",
"kioskModeManagedHomeScreenSignInBrandingLogo": "Kiosk Mode Managed Home Screen Sign In Branding Logo value",
"kioskModeManagedHomeScreenSignInEnabled": true,
"kioskModeUseManagedHomeScreenApp": "singleAppMode",
"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",
"passwordRequireUnlock": "daily",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"playStoreMode": "allowList",
"screenCaptureBlocked": true,
"securityDeveloperSettingsEnabled": true,
"securityRequireVerifyApps": true,
"shortHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"statusBarBlocked": true,
"stayOnModes": [
"ac"
],
"storageAllowUsb": true,
"storageBlockExternalMedia": true,
"storageBlockUsbFileTransfer": true,
"systemUpdateFreezePeriods": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",
"startMonth": 10,
"startDay": 8,
"endMonth": 8,
"endDay": 6
}
],
"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,
"personalProfileAppsAllowInstallFromUnknownSources": true,
"personalProfileCameraBlocked": true,
"personalProfileScreenCaptureBlocked": true,
"personalProfilePlayStoreMode": "blockedApps",
"personalProfilePersonalApplications": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinimumNumericCharacters": 11,
"workProfilePasswordMinimumNonLetterCharacters": 13,
"workProfilePasswordMinimumLetterCharacters": 10,
"workProfilePasswordMinimumLowerCaseCharacters": 13,
"workProfilePasswordMinimumUpperCaseCharacters": 13,
"workProfilePasswordMinimumSymbolCharacters": 10,
"workProfilePasswordPreviousPasswordCountToBlock": 15,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "required",
"workProfilePasswordRequireUnlock": "daily",
"locateDeviceUserlessDisabled": true,
"locateDeviceLostModeEnabled": true,
"androidDeviceOwnerDelegatedScopeAppSettings": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
"appDetail": {
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
},
"appScopes": [
"certificateInstall"
]
}
],
"shareDeviceLocationDisabled": true,
"deviceLocationMode": "disabled"
}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 10889
{
"@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,
"azureAdSharedDeviceDataClearApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"accountsBlockModification": true,
"appsAllowInstallFromUnknownSources": true,
"appsAutoUpdatePolicy": "userChoice",
"appsDefaultPermissionPolicy": "prompt",
"appsRecommendSkippingFirstUseHints": true,
"bluetoothBlockConfiguration": true,
"bluetoothBlockContactSharing": true,
"cameraBlocked": true,
"cellularBlockWiFiTethering": true,
"certificateCredentialConfigurationDisabled": true,
"crossProfilePoliciesAllowCopyPaste": true,
"crossProfilePoliciesAllowDataSharing": "crossProfileDataSharingBlocked",
"crossProfilePoliciesShowWorkContactsInPersonalProfile": 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,
"detailedHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"deviceOwnerLockScreenMessage": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"securityCommonCriteriaModeEnabled": true,
"factoryResetDeviceAdministratorEmails": [
"Factory Reset Device Administrator Emails value"
],
"factoryResetBlocked": true,
"globalProxy": {
"@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
"proxyAutoConfigURL": "Proxy Auto Config URL value"
},
"googleAccountsBlocked": true,
"kioskCustomizationDeviceSettingsBlocked": true,
"kioskCustomizationPowerButtonActionsBlocked": true,
"kioskCustomizationStatusBar": "notificationsAndSystemInfoEnabled",
"kioskCustomizationSystemErrorWarnings": true,
"kioskCustomizationSystemNavigation": "navigationEnabled",
"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"
],
"kioskModeAppOrderEnabled": true,
"kioskModeAppsInFolderOrderedByName": true,
"kioskModeGridHeight": 3,
"kioskModeGridWidth": 2,
"kioskModeLockHomeScreen": true,
"kioskModeManagedFolders": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeManagedFolder",
"folderName": "Folder Name value",
"folderIdentifier": "Folder Identifier value",
"items": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
]
}
],
"kioskModeAppPositions": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeAppPositionItem",
"position": 8,
"item": {
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
}
],
"kioskModeManagedHomeScreenAutoSignout": true,
"kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds": 7,
"kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds": 8,
"kioskModeManagedHomeScreenPinComplexity": "simple",
"kioskModeManagedHomeScreenPinRequired": true,
"kioskModeManagedHomeScreenPinRequiredToResume": true,
"kioskModeManagedHomeScreenSignInBackground": "Kiosk Mode Managed Home Screen Sign In Background value",
"kioskModeManagedHomeScreenSignInBrandingLogo": "Kiosk Mode Managed Home Screen Sign In Branding Logo value",
"kioskModeManagedHomeScreenSignInEnabled": true,
"kioskModeUseManagedHomeScreenApp": "singleAppMode",
"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",
"passwordRequireUnlock": "daily",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"playStoreMode": "allowList",
"screenCaptureBlocked": true,
"securityDeveloperSettingsEnabled": true,
"securityRequireVerifyApps": true,
"shortHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"statusBarBlocked": true,
"stayOnModes": [
"ac"
],
"storageAllowUsb": true,
"storageBlockExternalMedia": true,
"storageBlockUsbFileTransfer": true,
"systemUpdateFreezePeriods": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",
"startMonth": 10,
"startDay": 8,
"endMonth": 8,
"endDay": 6
}
],
"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,
"personalProfileAppsAllowInstallFromUnknownSources": true,
"personalProfileCameraBlocked": true,
"personalProfileScreenCaptureBlocked": true,
"personalProfilePlayStoreMode": "blockedApps",
"personalProfilePersonalApplications": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinimumNumericCharacters": 11,
"workProfilePasswordMinimumNonLetterCharacters": 13,
"workProfilePasswordMinimumLetterCharacters": 10,
"workProfilePasswordMinimumLowerCaseCharacters": 13,
"workProfilePasswordMinimumUpperCaseCharacters": 13,
"workProfilePasswordMinimumSymbolCharacters": 10,
"workProfilePasswordPreviousPasswordCountToBlock": 15,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "required",
"workProfilePasswordRequireUnlock": "daily",
"locateDeviceUserlessDisabled": true,
"locateDeviceLostModeEnabled": true,
"androidDeviceOwnerDelegatedScopeAppSettings": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
"appDetail": {
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
},
"appScopes": [
"certificateInstall"
]
}
],
"shareDeviceLocationDisabled": true,
"deviceLocationMode": "disabled"
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈