sysmail_update_principalprofile_sp (Transact-SQL)

Sintassi

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

Argomenti

• [ @principal_id = ] principal_id
  ID dell'utente del database o del ruolo nel database msdb per l'associazione da modificare. principal_id è di tipo int e il valore predefinito è NULL. È necessario specificare l'argomento principal_id o l'argomento principal_name.

• [ @principal_name = ] 'principal_name'
  Nome dell'utente del database o del ruolo nel database msdb per l'associazione da aggiornare. principal_name è di tipo sysname e il valore predefinito è NULL. È possibile specificare l'argomento principal_id o l'argomento principal_name.

• [ @profile_id = ] profile_id
  ID del profilo per l'associazione da modificare. profile_id è di tipo int e il valore predefinito è NULL. È necessario specificare l'argomento profile_id o l'argomento profile_name.

• [ @profile_name = ] 'profile_name'
  Nome del profilo per l'associazione da modificare. profile_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare l'argomento profile_id o l'argomento profile_name.

• [ @is_default = ] 'is_default'
  Specifica se il profilo è il profilo predefinito per l'utente del database. A un utente del database può essere associato un solo profilo predefinito. is_default è di tipo bit e non prevede alcun valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Questa stored procedure consente di modificare il profilo predefinito per l'utente del database. A un utente del database può essere associato un solo profilo privato predefinito.

Se il nome dell'entità per l'associazione è public o l'ID dell'entità per l'associazione è 0, questa stored procedure cambia il profilo pubblico. È possibile associare un solo profilo pubblico predefinito.

Se @is_default è '1' e l'entità è associata a più di un profilo, il profilo specificato diventa il profilo predefinito per l'entità. Il profilo che in precedenza era il profilo predefinito è tuttora associato all'entità, ma non è più il profilo predefinito.

La stored procedure sysmail_update_principalprofile_sp è disponibile nel database msdb ed è di proprietà dello schema dbo. La procedura deve essere eseguita con un nome in tre parti se il database corrente non è msdb.

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Esempi

A. Impostazione di un profilo come profilo pubblico predefinito per un database

Nell'esempio seguente viene impostato il profilo General Use Profile come profilo pubblico predefinito per gli utenti del database msdb.

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

B. Impostazione di un profilo come profilo privato predefinito per un utente

Nell'esempio seguente viene impostato il profilo AdventureWorks Administrator come profilo predefinito per l'entità ApplicationUser nel database msdb. Il profilo deve essere già associato all'entità. Il profilo che in precedenza era il profilo predefinito è tuttora associato all'entità, ma non è più il profilo predefinito.

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

Vedere anche

Riferimento

Concetti