sp_help_proxy (Transact-SQL)

Article
08/20/2013

Répertorie les informations d'un ou plusieurs serveurs proxy.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @proxy_id = ] id
Numéro d'identification du serveur proxy pour lequel énumérer les informations. L'argument proxy_id est de type int, avec NULL comme valeur par défaut. L'argument id ou proxy_name peut être spécifié.
[ @proxy_name = ] 'proxy_name'
Nom du serveur proxy pour lequel énumérer les informations. L'argument proxy_name est de type sysname, avec NULL comme valeur par défaut. L'argument id ou proxy_name peut être spécifié.

[ @subsystem_name = ] 'subsystem_name'
Nom du sous-système pour lequel énumérer les serveurs proxy. L'argument subsystem_name est de type sysname, avec NULL comme valeur par défaut. Lorsque l'argument subsystem_name est spécifié, la valeur de name doit également être spécifiée.

Le tableau suivant répertorie les valeurs possibles pour chaque sous-système.

Valeur	Description
ActiveScripting	Script ActiveX
CmdExec	Système d'exploitation (CmdExec)
Snapshot	Agent d'instantané des réplications
LogReader	Agent de lecture du journal des réplications
Distribution	Agent de distribution des réplications
Merge	Agent de fusion des réplications
QueueReader	Agent de lecture de la file d'attente
ANALYSISQUERY	Commande Analysis Services
ANALYSISCOMMAND	Requête Analysis Services
Dts	Exécution de package SSIS
PowerShell	script PowerShell

[ @name = ] 'name'
Nom d'une connexion SQL Server pour laquelle énumérer les serveurs proxy. Le nom est de type nvarchar(256), avec pour valeur par défaut NULL. Lorsque l'argument name est spécifié, la valeur de subsystem_name doit également être spécifiée.

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Nom de la colonne	Type de données	Description
proxy_id	int	Numéro d'identification du proxy.
name	sysname	Nom du proxy.
credential_identity	sysname	Nom du domaine Microsoft Windows et nom d'utilisateur pour les informations d'identification associées au serveur proxy.
enabled	tinyint	Indique si ce serveur proxy est activé. { 0 = not enabled, 1 = enabled }
description	nvarchar(1024)	Description de ce serveur proxy.
user_sid	varbinary(85)	Numéro d'identification de sécurité (SID) Windows de l'utilisateur Windows pour ce serveur proxy.
credential_id	int	Identifiant des informations d'identification associées à ce serveur proxy.
credential_identity_exists	int	Indique si l'identifiant des informations d'identification existe. { 0 = inexistant, 1 = existant }

Notes

Lorsque aucun paramètre n'est fourni, sp_help_proxy répertorie les informations pour tous les serveurs proxy de l'instance.

Pour déterminer les serveurs proxy qu'une connexion peut utiliser pour un sous-système donné, spécifiez name et subsystem_name. Lorsque ces arguments sont fournis, sp_help_proxy répertorie les serveurs proxy auxquels la connexion spécifiée peut accéder et qui sont utilisables pour le sous-système spécifié.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. D'autres utilisateurs doivent disposer du rôle de base de données fixe SQLAgentOperatorRole dans la base de données msdb.

Pour en savoir plus sur SQLAgentOperatorRole, consultez Rôles de base de données fixes de l'Agent SQL Server.

[!REMARQUE]

Les colonnes credential_identity et user_sid sont renvoyées dans l'ensemble de résultats uniquement lorsque ce sont des membres de sysadmin qui exécutent cette procédure stockée.

Exemples

A.Affichage des informations pour tous les serveurs proxy

L'exemple ci-dessous répertorie les informations pour tous les serveurs proxy de l'instance.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B.Affichage des informations pour un serveur proxy spécifique

L'exemple ci-dessous répertorie les informations pour le serveur proxy nommé Catalog application proxy.

USE msdb ;
GO

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

Voir aussi

Référence

Procédures stockées de l'Agent SQL Server (Transact-SQL)

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)

Partager via