sysmail_help_principalprofile_sp (Transact-SQL)

Syntax

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

Argumente

• [ @principal_id= ] principal_id
  Entspricht der ID des Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die aufzuführende Zuordnung. principal_id ist vom Datentyp int und hat den Standardwert NULL.Es kann entweder principal_id oder principal_name angegeben werden.

• [ @principal_name= ] 'principal_name'
  Entspricht dem Namen des Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die aufzuführende Zuordnung. principal_name ist vom Datentyp sysname und hat den Standardwert NULL.Es kann entweder principal_id oder principal_name angegeben werden.

• [ @profile_id= ] profile_id
  Die Profil-ID der Zuordnung, die aufgelistet werden soll. profile_id ist vom Datentyp int, der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.

• [ @profile_name= ] 'profile_name'
  Der Name des Profils für die Zuordnung, die aufgelistet werden soll. profile_name ist vom Datentyp sysname, der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Gibt ein Resultset zurück, das die in der folgenden Tabelle aufgelisteten Spalten enthält.

Hinweise

Wird sysmail_help_principalprofile_sp ohne Parameter aufgerufen, werden im zurückgegebenen Resultset alle Zuordnungen in der Instanz von SQL Server aufgelistet. Andernfalls enthält das Resultset Informationen zu Zuordnungen, die mit den bereitgestellten Parametern übereinstimmen. So listet beispielsweise die Prozedur alle Zuordnungen für ein Profil auf, wenn der Profilname bereitgestellt wird.

sysmail_help_principalprofile_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Die Prozedur muss mithilfe eines dreiteiligen Namens ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um msdb handelt.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

A. Auflisten von Informationen für eine bestimmte Zuordnung

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator' ;

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B. Auflisten von Informationen für alle Zuordnungen

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

Siehe auch

Verweis

Konzepte