Atualizar deviceManagementDerivedCredentialSettings

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto deviceManagementDerivedCredentialSettings .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (de privilégios máximos a mínimos)
Delegado (conta corporativa ou de estudante)
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Política de Acesso a Recursos	DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Política de Acesso a Recursos	DeviceManagementConfiguration.ReadWrite.All

Solicitação 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

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON para o objeto deviceManagementDerivedCredentialSettings .

A tabela a seguir mostra as propriedades necessárias ao criar o deviceManagementDerivedCredentialSettings.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Identificador exclusivo para a Credencial Derivada
Política de RA
helpUrl	Cadeia de caracteres	A URL que estará acessível aos usuários finais à medida que eles recuperam uma credencial derivada usando o Portal da Empresa.
displayName	Cadeia de caracteres	O nome de exibição do perfil.
Emissor	deviceManagementDerivedCredentialIssuer	O provedor de credencial derivado a ser usado. Os valores possíveis são: intercede, entrustDatacard, purebred.
Notificationtype	deviceManagementDerivedCredentialNotificationType	Os métodos usados para informar o usuário final a abrir Portal da Empresa para fornecer perfis de Wi-Fi, VPN ou email que usam certificados para o dispositivo. Os valores possíveis são: none, companyPortal, email.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e um objeto deviceManagementDerivedCredentialSettings atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

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

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

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

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