Atualizar deviceManagementDerivedCredentialSettingsUpdate deviceManagementDerivedCredentialSettings

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Atualize as propriedades de um objeto deviceManagementDerivedCredentialSettings.Update the properties of a deviceManagementDerivedCredentialSettings object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account)
    Configuração do dispositivo    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Política de Acesso a Recursos    Resource Access Policy DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
ApplicationApplication
    Configuração do dispositivo    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Política de Acesso a Recursos    Resource Access Policy DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

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

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, fornece uma representação JSON para o objeto deviceManagementDerivedCredentialSettings.In the request body, supply a JSON representation for the deviceManagementDerivedCredentialSettings object.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementDerivedCredentialSettings.The following table shows the properties that are required when you create the deviceManagementDerivedCredentialSettings.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Identificador exclusivo da Credencial DerivadaUnique identifier for the Derived Credential
Política raraRA Policy
helpUrlhelpUrl Cadeia de CaracteresString A URL que será acessível aos usuários finais à medida que eles recuperam uma credencial derivada usando o Portal da Empresa.The URL that will be accessible to end users as they retrieve a derived credential using the Company Portal.
displayNamedisplayName Cadeia de caracteresString O nome de exibição do perfil.The display name for the profile.
emissorissuer deviceManagementDerivedCredentialIssuerdeviceManagementDerivedCredentialIssuer O provedor de credenciais derivado a ser usado.The derived credential provider to use. Os valores possíveis são: intercede, entrustDatacard, purebred.Possible values are: intercede, entrustDatacard, purebred.
notificationTypenotificationType deviceManagementDerivedCredentialNotificationTypedeviceManagementDerivedCredentialNotificationType Os métodos usados para informar o usuário final para abrir o Portal da Empresa para fornecer perfis de Wi-Fi, VPN ou email que usam certificados no 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. Os valores possíveis são: none, companyPortal, email.Possible values are: none, companyPortal, email.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto deviceManagementDerivedCredentialSettings atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated deviceManagementDerivedCredentialSettings object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.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"
}

RespostaResponse

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.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"
}