sysmail_add_principalprofile_sp (języka Transact-SQL)

Składnia

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

Argumenty

• [ @ principal_id =] principal_id
  Identyfikator bazy danych użytkownika lub rolę w msdb bazy danych w celu skojarzenia.principal_idjest int, domyślna wartość NULL.Albo principal_id lub principal_name musi być określony.A principal_id z 0 ustawia ten profil profil publiczny, udzielanie dostępu do wszystkich podmiotów w bazie danych.

• [ @ principal_name =] 'principal_name"
  Nazwa bazy danych użytkownika lub rolę w msdb bazy danych w celu skojarzenia.principal_namejest sysname, domyślna wartość NULL.Albo principal_id lub principal_name musi być określony.A principal_name z 'public' ustawia ten profil profil publiczny, udzielanie dostępu do wszystkich podmiotów w bazie danych.

• [ @ profile_id =] profile_id
  Identyfikator profilu skojarzenia.profile_idjest int, domyślna wartość NULL.Albo profile_id lub profile_name musi być określony.

• [ @ nazwa_profilu =] 'profile_name"
  Nazwa profilu skojarzenia.profile_namejest sysname, z braku domyślne.Albo profile_id lub profile_name musi być określony.

• [ @ is_default =] is_default
  Określa, czy ten profil domyślny profil dla głównego zobowiązanego.Zleceniodawca musi mieć dokładnie jeden domyślny profil.is_defaultjest bit, z braku domyślne.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

Aby profil publiczny, określ @ principal_id z 0 lub @ principal_name z publicznych.Profil publiczny jest dostępny dla wszystkich użytkowników w msdb bazy danych, chociaż użytkownicy muszą być również element członkowski DatabaseMailUserRole do wykonać sp_send_dbmail.

Użytkownik bazy danych może mieć tylko jeden profil domyślny.Gdy @ is_default jest "1" użytkownik jest już skojarzony z jedną lub więcej profili, określony profil staje się domyślnego profilu użytkownika.Profil, który został uprzednio domyślny profil jest nadal skojarzona z użytkownikiem, ale nie jest już profil domyślny.

Gdy @ is_default jest "0" i nie skojarzenie istnieje, procedura składowana zwraca błąd.

procedura składowanasysmail_add_principalprofile_sp w msdb bazy danych i jest w posiadaniu dbo schematu. Procedury muszą być wykonane z nazwą trzech części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia domyślne tej procedury do członków wykonywania sysadmin stała rola serwera.

Przykłady

A.Tworzenie skojarzenia, ustawienie domyślnego profilu

Poniższy przykład tworzy skojarzenie między profil o nazwie AdventureWorks2008R2 Administrator Profile i msdb użytkownik bazy danych ApplicationUser.Profil jest domyślny profil użytkownika.

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

B.Tworzenie profilu domyślnego profilu publicznego

Poniższy przykład ustawia profil AdventureWorks2008R2 Public Profile domyślnego profilu publicznego dla użytkowników w msdb bazy danych.

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'AdventureWorks2008R2 Public Profile',
    @is_default = 1 ;

Zobacz także

Odwołanie

Koncepcje