更新 deviceManagementDerivedCredentialSettings

命名空间：microsoft.graph

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

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

更新 deviceManagementDerivedCredentialSettings 对象的 属性。

先决条件

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

权限类型	权限（从最高特权到最低特权）
委派（工作或学校帐户）
设备配置	DeviceManagementConfiguration.ReadWrite.All
资源访问策略	DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序
设备配置	DeviceManagementConfiguration.ReadWrite.All
资源访问策略	DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/derivedCredentials/{deviceManagementDerivedCredentialSettingsId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosVpnConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosEnterpriseWiFiConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosEasEmailProfileConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosDerivedCredentialAuthenticationConfiguration/derivedCredentialSettings

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	派生凭据的唯一标识符
RA 策略
helpUrl	String	最终用户在使用公司门户检索派生凭据时可访问的 URL。
displayName	String	配置文件的显示名称。
发行	deviceManagementDerivedCredentialIssuer	要使用的派生凭据提供程序。 可取值为：intercede、entrustDatacard、purebred。
notificationType	deviceManagementDerivedCredentialNotificationType	用于通知最终用户打开公司门户以将使用证书的 Wi-Fi、VPN 或电子邮件配置文件传送到设备的方法。 可取值为：none、companyPortal、email。

响应

如果成功，此方法在响应正文中返回 200 OK 响应代码和更新的 deviceManagementDerivedCredentialSettings 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/derivedCredentialSettings
Content-type: application/json
Content-length: 83

{
  "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings"
}

响应

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

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 132

{
  "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings",
  "id": "bc650741-0741-bc65-4107-65bc410765bc"
}