sysmail_update_principalprofile_sp (Transact-SQL)

Sintaxe

sysmail_update_principalprofile_sp { @principal_id = principal_id | @principal_name = 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    [ @is_default = ] 'is_default'

Argumentos

• [ @principal_id = ] principal_id
  A ID do usuário do banco de dados ou da função no banco de dados msdb da associação a ser alterada. principal_id é int, com um padrão NULL. É necessário especificar a principal_id ou o principal_name.

• [ @principal_name = ] 'principal_name'
  O nome do usuário do banco de dados ou da função no banco de dados msdb da associação a ser atualizada. principal_name é sysname, com um padrão NULL. Pode ser especificada a principal_id ou o principal_name.

• [ @profile_id = ] profile_id
  A ID do perfil da associação a ser alterada. profile_id é int, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

• [ @profile_name = ] 'profile_name'
  O nome do perfil da associação a ser alterada. profile_name é sysname, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

• [ @is_default = ] 'is_default'
  Se este é o perfil padrão para o usuário do banco de dados. Um usuário de banco de dados pode ter somente um perfil padrão. is_default é bit, sem padrão.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Este procedimento armazenado será alterado se o perfil especificado for o padrão para o usuário do banco de dados. Um usuário de banco de dados pode ter somente um perfil privado padrão.

Quando o nome da entidade da associação for público ou a ID da entidade da associação for 0, este procedimento armazenado alterará o perfil público. Pode haver somente um perfil público padrão.

Quando @is_default for '1' e a entidade estiver associada a mais de um perfil, o perfil especificado será o perfil padrão para a entidade. O perfil que anteriormente era o padrão ainda estará associado à entidade, mas não mais será o perfil padrão.

O procedimento armazenado sysmail_update_principalprofile_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

A. Definindo um perfil para ser o perfil público padrão para um banco de dados

O exemplo a seguir define o perfil General Use Profile para ser o perfil público padrão para usuários no banco de dados msdb.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'General Use Profile',
    @is_default = '1';

B. Definindo um perfil para ser o perfil privado padrão para um usuário

O exemplo a seguir define o perfil AdventureWorks2008R2 Administrator como o perfil padrão da entidade ApplicationUser no banco de dados msdb. O perfil já deve estar associado à entidade. O perfil que anteriormente era o padrão ainda estará associado à entidade, mas não mais será o perfil padrão.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks2008R2 Administrator',
    @is_default = '1' ;

Consulte também

Referência

Conceitos