sysmail_update_principalprofile_sp (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 12 dicembre 2006

Aggiorna le informazioni per un'associazione tra un'entità di msdb e un profilo.

Icona di collegamento a un argomento Convenzioni della 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 del database msdb o 0 per il ruolo public. 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 msdb o 'public' per il ruolo public. 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.

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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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

Cronologia modifiche

Versione	Cronologia
12 dicembre 2006	Contenuto modificato: Indicazioni relative agli utenti del database msdb e al fatto che il ruolo è limitato al ruolo public.

Condividi tramite