Share via


sp_help_proxy (Transact-SQL)

列出一或多個 Proxy 的資訊。

主題連結圖示Transact-SQL 語法慣例

語法

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

引數

  • [ @proxy_id = ] id
    要列出資訊的 Proxy 之 Proxy 識別碼。proxy_id 是 int,預設值是 NULL。您只能指定 id 或 proxy_name 其中之一。

  • [ @proxy_name = ] 'proxy_name'
    要列出資訊的 Proxy 名稱。proxy_name 是 sysname,預設值是 NULL。您只能指定 id 或 proxy_name 其中之一。

  • [ @subsystem_name = ] 'subsystem_name'
    要列出 Proxy 的子系統名稱。subsystem_name 是 sysname,預設值是 NULL。當指定 subsystem_name 時,也必須指定 name。

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

    描述

    ActiveScripting

    ActiveX Script

    CmdExec

    作業系統 (CmdExec)

    Snapshot

    複寫快照集代理程式

    LogReader

    複寫記錄讀取器代理程式

    Distribution

    複寫散發代理程式

    Merge

    複寫合併代理程式

    QueueReader

    複寫佇列讀取器代理程式

    ANALYSISQUERY

    Analysis Services 命令

    ANALYSISCOMMAND

    Analysis Services 查詢

    Dts

    SSIS 封裝執行

    PowerShell

    PowerShell 指令碼

  • [ @name = ] 'name'
    要列出 Proxy 的 SQL Server 登入名稱。這個名稱是 nvarchar(256),預設值是 NULL。當指定 name 時,也必須指定 subsystem_name。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱

資料類型

描述

proxy_id

int

Proxy 識別碼。

name

sysname

Proxy 的名稱。

credential_identity

sysname

Proxy 相關認證的 Microsoft Windows 網域名稱和使用者名稱。

enabled

tinyint

是否啟用這個 Proxy。{ 0 = 未啟用,1 = 已啟用 }

description

nvarchar(1024)

這個 Proxy 的描述。

user_sid

varbinary(85)

這個 Proxy 的 Windows 使用者之 Windows 安全性識別碼。

credential_id

int

這個 Proxy 的相關認證識別碼。

credential_identity_exists

int

credential_identity 是否存在。{ 0 = 不存在,1 = 存在 }

備註

當未提供任何參數時,sp_help_proxy 會列出執行個體中所有 Proxy 的資訊。

若要判斷登入在給定子系統上能夠使用哪些 Proxy,請指定 name 和 subsystem_name。當提供這些引數時,sp_help_proxy 會列出指定的登入能夠存取,且可供指定之子系統使用的 Proxy。

權限

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

如需有關 SQLAgentOperatorRole 的詳細資料,請參閱<SQL Server Agent 固定資料庫角色>。

[!附註]

系統管理員 (sysadmin) 的成員執行此預設程序時,在結果集內只傳回 credential_identityuser_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