Actualizar deviceManagementDerivedCredentialSettings

Espacio de nombres: 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.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto deviceManagementDerivedCredentialSettings .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

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.

Tipo de permiso	Permisos (de más a menos privilegiados)
Delegado (cuenta profesional o educativa)
Configuración del dispositivo	DeviceManagementConfiguration.ReadWrite.All
Directiva de acceso a recursos	DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación
Configuración del dispositivo	DeviceManagementConfiguration.ReadWrite.All
Directiva de acceso a recursos	DeviceManagementConfiguration.ReadWrite.All

Solicitud 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

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto deviceManagementDerivedCredentialSettings .

En la tabla siguiente se muestran las propiedades necesarias al crear deviceManagementDerivedCredentialSettings.

Propiedad	Tipo	Descripción
id	Cadena	Identificador único de la credencial derivada
Directiva de RA
helpUrl	Cadena	Dirección URL a la que podrán acceder los usuarios finales a medida que recuperen una credencial derivada mediante el Portal de empresa.
displayName	Cadena	Nombre para mostrar del perfil.
Emisor	deviceManagementDerivedCredentialIssuer	Proveedor de credenciales derivado que se va a usar. Los valores posibles son: intercede, entrustDatacard y purebred.
notificationType	deviceManagementDerivedCredentialNotificationType	Los métodos utilizados para informar al usuario final de que abra Portal de empresa para entregar perfiles de Wi-Fi, VPN o correo electrónico que usan certificados en el dispositivo. Los valores posibles son: none, companyPortal y email.

Respuesta

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.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

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

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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

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