sp_help_proxy （Transact-SQL）

發行項
08/21/2023

適用於：SQL Server

列出一或多個 Proxy 的資訊。

語法

  
sp_help_proxy   
    [ @proxy_id = ] id,  
    [ @proxy_name = ] 'proxy_name' ,  
    [ @subsystem_name = ] 'subsystem_name' ,  
    [ @name = ] 'name'

引數

[ @proxy_id = ] id 要列出資訊的 Proxy 識別碼。 proxy_id 為 int ，預設值為 Null。可以指定識別碼或 proxy_name 。

[ @proxy_name = ] 'proxy_name' 要列出資訊的 Proxy 名稱。 proxy_name 為 sysname ，預設值為 Null。可以指定識別碼或 proxy_name 。

[ @subsystem_name = ] 'subsystem_name' 要列出 Proxy 的子系統名稱。 subsystem_name 為 sysname ，預設值為 Null。指定subsystem_name 時， 也必須指定名稱 。

下表列出每個子系統的值。

值	Description
ActiveScripting	ActiveX 腳本
CmdExec	作業系統 (CmdExec)
Snapshot	Replication Snapshot Agent
LogReader	複寫記錄讀取器代理程式
散發	Replication Distribution Agent
合併	Replication Merge Agent
QueueReader	複寫佇列讀取器代理程式
ANALYSISQUERY	Analysis Services 命令
ANALYSISCOMMAND	Analysis Services 查詢
Dts	SSIS 封裝執行
PowerShell	PowerShell 指令碼

[ @name = ] 'name' 要列出 Proxy 的 SQL Server 登入名稱。名稱為 Nvarchar（256） ，預設值為 Null。指定名稱時， 也必須指定subsystem_name 。

傳回碼值

0 （成功）或 1 （失敗）

結果集

資料行名稱	資料類型	描述
proxy_id	int	Proxy 識別碼。
name	sysname	Proxy 的名稱。
credential_identity	sysname	與 Proxy 相關聯之認證的 Microsoft Windows 功能變數名稱和使用者名稱。
「已啟用」	tinyint	是否啟用此 Proxy。 { 0 = 未啟用， 1 = enabled }
description	nvarchar(1024)	此 Proxy 的描述。
user_sid	varbinary(85)	此 Proxy 之 Windows 使用者的 Windows 安全性識別碼。
credential_id	int	與此 Proxy 相關聯的認證識別碼。
credential_identity_exists	int	credential_identity是否存在。 { 0 = 不存在，1 = exists }

備註

如果未提供任何參數， sp_help_proxy 會列出實例中所有 Proxy 的資訊。

若要判斷登入可用於指定子系統的 Proxy，請指定 名稱和 subsystem_name 。提供這些引數時， sp_help_proxy 列出指定的登入可以存取的 Proxy，以及可用於指定子系統的 Proxy。

權限

依預設，只有 系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的 SQLAgentOperatorRole 固定資料庫角色。

如需 SQLAgentOperatorRole 的詳細資訊 ，請參閱 SQL Server Agent 固定資料庫角色。

注意

只有在 sysadmin 的成員 執行這個預存程式時，才會在結果集中傳回credential_identity 和 user_sid 資料行。

範例

A. 列出所有 Proxy 的資訊

下列範例會列出實例中所有 Proxy 的資訊。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_proxy ;  
GO

B. 列出特定 Proxy 的資訊

下列範例會列出名為 Catalog application proxy 的 Proxy 資訊。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_proxy  
    @proxy_name = N'Catalog application proxy' ;  
GO

另請參閱

SQL Server Agent 預存程式（Transact-SQL）
sp_add_proxy (Transact-SQL)
sp_delete_proxy （Transact-SQL）