sp_help_proxy (Transact-SQL)

Gäller för:SQL Server

Listar information för en eller flera proxyer.

Transact-SQL syntaxkonventioner

Syntax

sp_help_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @subsystem_name = ] N'subsystem_name' ]
    [ , [ @name = ] N'name' ]
[ ; ]

Arguments

[ @proxy_id = ] proxy_id

Proxyidentifieringsnumret för proxyn för att lista information för. @proxy_id är int, med standardvärdet .NULL Antingen @proxy_id eller @proxy_name kan specificeras.

[ @proxy_name = ] N'proxy_name'

Namnet på proxyn för att lista information. @proxy_name är sysname, med standardvärdet .NULL Antingen @proxy_id eller @proxy_name kan specificeras.

[ @subsystem_name = ] N'subsystem_name'

Namnet på delsystemet att lista proxyer för. @subsystem_name är sysname, med standardvärdet .NULL När @subsystem_name anges måste @name också specificeras.

Följande tabell listar värdena för varje delsystem.

Värde Description
ActiveScripting ActiveX-skript
CmdExec Operativsystem (CmdExec)
Snapshot Replikeringsögonblicksagent
LogReader Läsagent för replikeringslogg
Distribution Replikeringsdistributionsagent
Merge Kopplingsagent för replikering
QueueReader Replikeringsköläsaragent
ANALYSISQUERY Analysis Services-kommandot
ANALYSISCOMMAND Fråga om analystjänster
Dts Körning av SSIS-paket
PowerShell PowerShell-skript

[ @name = ] N'namn'

Namnet på en SQL Server-inloggning för att lista proxyservrar. @name är nvarchar(256), med en standard på NULL. När @name anges måste @subsystem_name också specificeras.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Datatyp Description
proxy_id int Proxy-identifikationsnummer.
name sysname Namnet på proxyn.
credential_identity sysname Microsoft Windows-domännamnet och användarnamnet för inloggningsuppgifterna som är kopplade till proxyn.
enabled tinyint Specificerar om denna proxy är aktiverad. 0 = inte aktiverad, 1 = aktiverad.
description nvarchar(1024) Beskrivningen för denna proxy.
user_sid varbinary(85) Windows-säkerhets-ID:t för Windows-användaren för denna proxy.
credential_id int Identifieraren för den legitimation som är kopplad till denna proxy.
credential_identity_exists int Specificerar om det credential_identity finns. 0 = existerar inte, 1 = existerar.

Anmärkningar

När inga parametrar tillhandahålls, sp_help_proxy listas information för alla proxyer i instansen.

För att avgöra vilka proxyer en inloggning kan använda för ett givet delsystem, specificera @name och @subsystem_name. När dessa argument tillhandahålls, sp_help_proxy listas proxyer som den angivna inloggningen kan komma åt och som kan användas för det angivna delsystemet.

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Kolumnerna credential_identity och user_sid returneras endast i resultatuppsättningen när medlemmar i sysadmin utför denna lagrade procedur.

Examples

A. Listinformation för alla proxyer

Följande exempel listar information för alla proxyer i instansen.

USE msdb;
GO

EXECUTE dbo.sp_help_proxy;
GO

B. Listainformation för en specifik proxy

Följande exempel listar information för proxyn med namnet Catalog application proxy.

USE msdb;
GO

EXECUTE dbo.sp_help_proxy @proxy_name = N'Catalog application proxy';
GO