sp_help_proxy (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Listet Informationen zu mindestens einem Proxy auf.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @proxy_id = ] id Die Proxy-ID des Proxys, für den Informationen aufgelistet werden sollen. Die proxy_id ist int, wobei der Standardwert NULL ist. Es kann entweder die ID oder die proxy_name angegeben werden.

[ @proxy_name = ] 'proxy_name' Der Name des Proxys, für den Informationen aufgelistet werden sollen. Die proxy_name ist sysname mit dem Standardwert NULL. Es kann entweder die ID oder die proxy_name angegeben werden.

[ @subsystem_name = ] 'subsystem_name' Der Name des Subsystems, für das Proxys aufgelistet werden sollen. Die subsystem_name ist sysname, wobei der Standardwert NULL ist. Wenn subsystem_name angegeben wird, muss auch der Name angegeben werden.

In der folgenden Tabelle werden die Werte für jedes Subsystem aufgelistet.

Wert BESCHREIBUNG
ActiveScripting ActiveX-Skript
CmdExec Betriebssystem (CmdExec)
Snapshot Replikationsmomentaufnahme-Agent
LogReader Replikationsprotokolllese-Agent
Distribution Replikationsverteilungs-Agent
Merge Replikationsmerge-Agent
QueueReader Warteschlangenlese-Agent der Microsoft SQL Server-Replikation
ANALYSISQUERY Analysis Services-Befehl
ANALYSISCOMMAND Analysis Services-Abfrage
Dts SSIS-Paketausführung
PowerShell PowerShell-Skript

[ @name = ] 'name'Der Name einer SQL Server Anmeldung, für die Proxys aufgelistet werden sollen. Der Name ist nvarchar(256) mit dem Standardwert NULL. Wenn name angegeben wird, muss auch subsystem_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname Datentyp BESCHREIBUNG
proxy_id int ID des Proxys.
name sysname Der Name des Proxys.
credential_identity sysname Der Microsoft Windows-Domänenname und -Benutzername für die dem Proxy zugeordneten Anmeldeinformationen.
enabled tinyint Gibt an, ob dieser Proxy aktiviert ist. { 0 = nicht aktiviert, 1 = aktiviert }
description nvarchar(1024) Die Beschreibung des Proxys.
user_sid varbinary(85) Die Windows-SID des Windows-Benutzers für diesen Proxy.
credential_id int Die ID für die dem Proxy zugeordneten Anmeldeinformationen.
credential_identity_exists int Gibt an, ob credential_identity vorhanden ist. { 0 = ist nicht vorhanden, 1 = ist vorhanden }

Bemerkungen

Wenn keine Parameter bereitgestellt werden, listet sp_help_proxy Informationen für alle Proxys in der Instanz auf.

Um zu bestimmen, welche Proxys eine Anmeldung für ein bestimmtes Subsystem verwenden kann, geben Sie name und subsystem_name an. Wenn diese Argumente bereitgestellt werden, listet sp_help_proxy Proxys auf, auf die die angegebene Anmeldung zugreifen kann und die für das angegebene Subsystem verwendet werden können.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen Datenbankrolle SQLAgentOperatorRole in der msdb -Datenbank sein.

Ausführliche Informationen zu SQLAgentOperatorRole finden Sie unter SQL Server-Agent Feste Datenbankrollen.

Hinweis

Die spalten credential_identity und user_sid werden nur dann im Resultset zurückgegeben, wenn Mitglieder von sysadmin diese gespeicherte Prozedur ausführen.

Beispiele

A. Auflistungsinformationen für alle Proxys

Im folgenden Beispiel werden die Informationen zu allen Proxys in der Instanz aufgelistet.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_proxy ;  
GO

B. Auflistungsinformationen für einen bestimmten Proxy

Im folgenden Beispiel werden die Informationen zum Proxy Catalog application proxy aufgelistet.

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

Weitere Informationen

Gespeicherte Prozeduren des SQL Server-Agents (Transact-SQL)
sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL)