sysmail_update_principalprofile_sp (Transact-SQL)
Si applica a: 
SQL Server
Aggiorna le informazioni per un'associazione tra un'entità e un profilo.
Convenzioni relative alla sintassi 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 o del msdb ruolo del database nel database da modificare. principal_id è int, con il valore predefinito NULL. È necessario specificare @principal_id o @principal_name .
[ @principal_name = ] 'principal_name'
Nome dell'utente o del msdb ruolo del database nel database per l'associazione da aggiornare. principal_name è sysname, con un valore predefinito .NULL È necessario specificare @principal_id o @principal_name .
[ @profile_id = ] profile_id
ID del profilo da modificare per l'associazione. @profile_id è int, con il valore predefinito NULL. È necessario specificare @profile_id o @profile_name .
[ @profile_name = ] 'profile_name'
Nome del profilo per l'associazione da modificare. @profile_name è sysname, con il valore predefinito NULL. È necessario specificare @profile_id o @profile_name .
[ @is_default = ] is_default
Indica se questo profilo è il profilo predefinito per l'utente del database. Un utente del database potrebbe avere un solo profilo predefinito. @is_default è bit, senza impostazione predefinita.
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Set di risultati
Nessuno.
Osservazioni:
Questa stored procedure consente di modificare il profilo predefinito per l'utente del database. Un utente del database potrebbe avere un solo profilo privato predefinito.
Quando il nome dell'entità per l'associazione è pubblico o l'ID principale per l'associazione è 0, questa stored procedure modifica il profilo pubblico. È possibile associare un solo profilo pubblico predefinito.
Quando @is_default è 1 e l'entità è associata a più profili, 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 si trova nel msdb database ed è di proprietà dello schema dbo . La procedura deve essere eseguita con un nome in tre parti se il database corrente non msdbè .
Autorizzazioni
È possibile concedere EXECUTE autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero essere sottoposte a override durante un aggiornamento di SQL Server.
Esempi
R. Impostare un profilo come profilo pubblico predefinito per un database
L'esempio seguente imposta il profilo General Use Profile come profilo pubblico predefinito per gli utenti nel msdb database.
EXEC msdb.dbo.sysmail_update_principalprofile_sp
@principal_name = 'public',
@profile_name = 'General Use Profile',
@is_default = '1';
B. Impostare un profilo come profilo privato predefinito per un utente
Nell'esempio seguente il profilo AdventureWorks Administrator viene impostato come profilo predefinito per l'entità ApplicationUser di sicurezza nel msdb database. 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.
EXEC msdb.dbo.sysmail_update_principalprofile_sp
@principal_name = 'ApplicationUser',
@profile_name = 'AdventureWorks Administrator',
@is_default = '1' ;