sp_help_proxy (Transact-SQL)

Artikel
06/18/2013

Listet Informationen zu mindestens einem Proxy auf.

Themenlink (Symbol) 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, zu dem die Informationen aufgelistet werden sollen. proxy_id ist vom Datentyp int und hat den Standardwert NULL. Es kann entweder id oder proxy_name angegeben werden.
[ @proxy_name = ] 'proxy_name'
Der Name des Proxys, zu dem Informationen aufgelistet werden sollen. proxy_name ist vom Datentyp sysname und hat den Standardwert NULL. Es kann entweder id oder proxy_name angegeben werden.

[ @subsystem_name = ] 'subsystem_name'
Der Name des Subsystems, für den Proxys aufgelistet werden sollen. subsystem_name ist vom Datentyp sysname und hat den Standardwert NULL. Wenn subsystem_name angegeben ist, muss auch name angegeben sein.

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

Wert	Beschreibung
ActiveScripting	ActiveX-Skript
CmdExec	Betriebssystem (CmdExec)
Momentaufnahme	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 vom Datentyp nvarchar(256) und hat den Standardwert NULL. Wenn name angegeben ist, muss auch subsystem_name angegeben sein.

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 der 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 }

Hinweise

Wenn keine Parameter bereitgestellt sind, listet sp_help_proxy Informationen zu allen Proxys in der Instanz auf.

Sie können bestimmen, welche Proxys eine Anmeldung für ein bestimmtes Subsystem verwenden kann, indem Sie name und subsystem_name angeben. Bei Bereitstellung dieser Argumente werden von sp_help_proxy die Proxys aufgelistet, auf die der angegebene Anmeldename 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 Feste Datenbankrollen des SQL Server-Agents.

Hinweis
Die Spalten credential_identity und user_sid werden im Resultset nur zurückgegeben, wenn die gespeicherte Prozedur von Mitgliedern der sysadmin-Rolle ausgeführt wird.

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

Siehe auch

Verweis

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

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)

Freigeben über