發行項
09/24/2010

sp_help_notification (Transact-SQL)

報告一份給定操作員的警示清單，或一份給定警示的操作員清單。

語法

sp_help_notification
     [ @object_type = ] 'object_type' ,
     [ @name = ] 'name' ,
     [ @enum_type = ] 'enum_type' , 
     [ @notification_method = ] notification_method 
     [ , [ @target_name = ] 'target_name' ]

引數

[@object_type =] 'object_type'
要傳回的資訊類型。object_type 是 char(9)，沒有預設值。object_type 可能是 ALERTS 或 OPERATORS。ALERTS 會列出指派給所提供之操作員名稱的警示*，OPERATORS 會列出負責所提供之警示名稱的操作員。*
[@name =] 'name'
運算子名稱 (如果 object_type 是 OPERATORS) 或警示名稱 (如果 object_type 是 ALERTS)。name 是 sysname，沒有預設值。

[@enum_type =] 'enum_type'
傳回的 object_type 資訊。在大部分情況下，enum_type 是 ACTUAL。enum_type 是 char(10)，沒有預設值，它可以是下列值之一。

值	描述
ACTUAL	只列出關聯於 object_types 的 name。
ALL	列出所有 object_types，未關聯於name 的項目也包括在內。
TARGET	只列出符合所提供之 object_types 的 target_name，無論是否關聯於name，都是如此。

[@notification_method =] notification_method
用來決定將傳回的通知方法資料行之數值。notification_method 是 tinyint，它可以是下列值之一。

值	描述
1	電子郵件：只傳回 use_email 資料行。
2	呼叫器：只傳回 use_pager 資料行。
4	NetSend：只傳回 use_netsend 資料行。
7	全部：傳回所有資料行。

[@target_name =] 'target_name'
要搜尋的警示名稱 (如果 object_type 是 ALERTS) 或要搜尋的操作員名稱 (如果 object_type 是 OPERATORS)。只有在 target_name 是 TARGET 時，才需要 enum_type。target_name 是 sysname，預設值是 NULL。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

如果 object_type 是 ALERTS，結果集會列出給定操作員的所有警示。

資料行名稱	資料類型	描述
alert_id	int	警示識別碼。
alert_name	sysname	警示名稱。
use_email	int	利用電子郵件來通知操作員： 1 = 是 0 = 否
use_pager	int	利用呼叫器來通知操作員： 1 = 是 0 = 否
use_netsend	int	利用網路快顯視窗來通知操作員： 1 = 是 0 = 否
has_email	int	這個警示所傳送的電子郵件通知數目。
has_pager	int	這個警示所傳送的呼叫器通知數目。
has_netsend	int	這個警示所傳送的 net send 通知數目。

如果 object_type 是 OPERATORS，結果集會列出給定警示的所有操作員。

資料行名稱	資料類型	描述
operator_id	int	操作員識別碼。
operator_name	sysname	操作員名稱。
use_email	int	利用電子郵件來傳送操作員的通知： 1 = 是 0 = 否
use_pager	int	利用呼叫器來傳送操作員的通知： 1 = 是 0 = 否
use_netsend	int	這是用來通知操作員的網路快顯視窗： 1 = 是 0 = 否
has_email	int	操作員有電子郵件地址： 1 = 是 0 = 否
has_pager	int	操作員具有呼叫器號碼： 1 = 是 0 = 否
has_netsend	int	操作員已設定了 net send 通知。 1 = 是 0 = 否

備註

這個預存程序必須從 msdb 資料庫中執行。

權限

若要執行這個預存程序，使用者必須是系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 列出特定操作員的警示

下列範例會傳回 François Ajenstat 操作員收到的任何一種通知所針對的所有警示。

USE msdb ;
GO

EXEC dbo.sp_help_notification 
    @object_type = N'ALERTS',
    @name = N'François Ajenstat',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO

B. 列出特定警示的操作員

下列範例會傳回收到 Test Alert 警示的任何一種通知的所有操作員。

USE msdb ;
GO

EXEC sp_help_notification
    @object_type = N'OPERATORS',
    @name = N'Test Alert',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO