Actualizar deviceManagementDerivedCredentialSettingsUpdate deviceManagementDerivedCredentialSettings

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante: Las API de Microsoft Graph en la versión/beta están sujetas a cambios; no se admite el uso de producción.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Actualice las propiedades de un objeto deviceManagementDerivedCredentialSettings .Update the properties of a deviceManagementDerivedCredentialSettings object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account)
    Configuración de dispositivos    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Directiva de acceso a recursos    Resource Access Policy DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication
    Configuración de dispositivos    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Directiva de acceso a recursos    Resource Access Policy DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitud HTTPHTTP Request

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

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto deviceManagementDerivedCredentialSettings .In the request body, supply a JSON representation for the deviceManagementDerivedCredentialSettings object.

En la tabla siguiente se muestran las propiedades necesarias para crear el deviceManagementDerivedCredentialSettings.The following table shows the properties that are required when you create the deviceManagementDerivedCredentialSettings.

PropiedadProperty TipoType DescripciónDescription
idid StringString Identificador único de la credencial derivadaUnique identifier for the Derived Credential
Directiva de RARA Policy
helpUrlhelpUrl StringString La URL a la que tendrán acceso los usuarios finales cuando recuperen una credencial derivada mediante el portal de la empresa.The URL that will be accessible to end users as they retrieve a derived credential using the Company Portal.
displayNamedisplayName StringString El nombre para mostrar del perfil.The display name for the profile.
emisorissuer deviceManagementDerivedCredentialIssuerdeviceManagementDerivedCredentialIssuer El proveedor de credenciales derivada que se va a usar.The derived credential provider to use. Los valores posibles son: intercede, entrustDatacard y purebred.Possible values are: intercede, entrustDatacard, purebred.
notificationTypenotificationType deviceManagementDerivedCredentialNotificationTypedeviceManagementDerivedCredentialNotificationType Los métodos que se usan para informar al usuario final de que abran el portal de la empresa para proporcionar perfiles de correo electrónico, VPN o Wi-Fi que usen certificados para el dispositivo.The methods used to inform the end user to open Company Portal to deliver Wi-Fi, VPN, or email profiles that use certificates to the device. Los valores posibles son: none, companyPortal y email.Possible values are: none, companyPortal, email.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto deviceManagementDerivedCredentialSettings actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated deviceManagementDerivedCredentialSettings object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

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

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

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.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: 132

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