反馈 编辑

创建 deviceManagementConfigurationRedirectSettingDefinition

  • 项目

命名空间：microsoft.graph

重要： /beta 版本下的 Microsoft Graph API 可能会发生更改;不支持生产用途。

注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。

创建新的 deviceManagementConfigurationRedirectSettingDefinition 对象。

先决条件

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
Application DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

POST /deviceManagement/reusableSettings
POST /deviceManagement/complianceSettings
POST /deviceManagement/configurationSettings
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions
POST /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions

请求标头

标头 值
Authorization Bearer <token>。必需。
接受 application/json

请求正文

在请求正文中，为 deviceManagementConfigurationRedirectSettingDefinition 对象提供 JSON 表示形式。

下表显示了创建 deviceManagementConfigurationRedirectSettingDefinition 时所需的属性。

属性 类型 说明
适用性 deviceManagementConfigurationSettingApplicability 详细信息：从 deviceManagementConfigurationSettingDefinition 继承的设备设置适用
accessTypes deviceManagementConfigurationSettingAccessTypes 从 deviceManagementConfigurationSettingDefinition 继承的设置的读/写访问模式。 可取值为：none、add、copy、delete、get、replace 或 execute。
keywords 字符串集合 要在从 deviceManagementConfigurationSettingDefinition 上搜索设置的令牌
infoUrls String 集合 可在从 deviceManagementConfigurationSettingDefinition 继承处找到有关设置的链接的详细信息列表
发生 deviceManagementConfigurationSettingOccurrence 指示是否需要设置从 deviceManagementConfigurationSettingDefinition 继承
baseUri String 从 deviceManagementConfigurationSettingDefinition 继承的基本 CSP 路径
offsetUri 字符串 从 deviceManagementConfigurationSettingDefinition 继承的基础的偏移 CSP 路径
rootDefinitionId String 根设置定义（如果设置是子设置）。 继承自 deviceManagementConfigurationSettingDefinition
categoryId 字符串 指定在指定的配置服务提供程序中配置设置的区域组 (CSP) 从 deviceManagementConfigurationSettingDefinition 继承
settingUsage deviceManagementConfigurationSettingUsage 设置类型，例如，从 deviceManagementConfigurationSettingDefinition 继承的配置和符合性。 可取值为：none、configuration、compliance。
uxBehavior deviceManagementConfigurationControlType 在从 deviceManagementConfigurationSettingDefinition 继承的 UX 中设置控件类型表示形式。 可取值为：default、dropdown、smallTextBox、largeTextBox、toggle、multiheaderGrid 或 contextPane。
visibility deviceManagementConfigurationSettingVisibility 将可见性范围设置为从 deviceManagementConfigurationSettingDefinition 继承的 UX。 可取值为：none、settingsCatalog、template。
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation 集合 引用的设置信息列表。 继承自 deviceManagementConfigurationSettingDefinition
id String 从 deviceManagementConfigurationSettingDefinition 继承的项的标识符
说明 字符串 从 deviceManagementConfigurationSettingDefinition 继承的项目说明
helpText 字符串 从 deviceManagementConfigurationSettingDefinition 继承的项目帮助文本
name String 从 deviceManagementConfigurationSettingDefinition 继承的项目名称
displayName 字符串 从 deviceManagementConfigurationSettingDefinition 继承的项的显示名称
version String 从 deviceManagementConfigurationSettingDefinition 继承的项目版本
deepLink 字符串 指向Intune控制台中必须从中管理功能支持的特定位置的深层链接。
redirectMessage String 一条消息说明单击链接会将用户重定向到受支持的页面以管理设置。
redirectReason String 指示将用户重定向到控制台中的替代位置的原因。 例如：设置目录不支持 WiFi 配置文件，必须使用模板策略创建。

响应

如果成功，此方法在响应正文中返回 201 Created 响应代码和 deviceManagementConfigurationRedirectSettingDefinition 对象。

示例

请求

下面是一个请求示例。

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}

响应

下面是一个响应示例。注意：为了简单起见，可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1445

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "3e6c3eab-3eab-3e6c-ab3e-6c3eab3e6c3e",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}