Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Microsoft admite las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versió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 .
## Permissions
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 |
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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 autenticación y 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 que se requieren para crear el deviceManagementDerivedCredentialSettings.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único de la credencial derivada |
| Directiva de RA | ||
| helpUrl | Cadena | Dirección URL a la que tendrán acceso los usuarios finales cuando recuperen una credencial derivada mediante el Portal de empresa. |
| displayName | Cadena | El nombre para mostrar del perfil. |
| emisor | deviceManagementDerivedCredentialIssuer | Proveedor de credenciales derivadas que se va a usar. Los valores posibles son: intercede, entrustDatacard, purebred. |
| notificationType | deviceManagementDerivedCredentialNotificationType | Los métodos usados para informar al usuario final de que abra el Portal de empresa para entregar al dispositivo perfiles Wi-Fi, VPN o de correo electrónico que usen certificados. Los valores posibles son: none, companyPortal, email. |
Respuesta
Si se realiza 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"
}