Skip to content

sp-msx-enlist-transact-sql.md

Latest commit

 

History

History
77 lines (54 loc) · 2.3 KB

sp-msx-enlist-transact-sql.md

File metadata and controls

77 lines (54 loc) · 2.3 KB
title sp_msx_enlist (Transact-SQL)
description sp_msx_enlist adds the current server to the list of available servers on the master server.
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
f1_keywords
sp_msx_enlist_TSQL
sp_msx_enlist
helpviewer_keywords
sp_msx_enlist
dev_langs
TSQL

sp_msx_enlist (Transact-SQL)

[!INCLUDE SQL Server]

Adds the current server to the list of available servers on the master server.

Caution

The sp_msx_enlist stored procedure edits the registry. Manual editing of the registry isn't recommended, because inappropriate or incorrect changes can cause serious configuration problems for your system. Therefore, only experienced users should use the Registry Editor program to edit the registry. For more information, see the Microsoft Windows documentation.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_msx_enlist
    [ @msx_server_name = ] N'msx_server_name'
    [ , [ @location = ] N'location' ]
[ ; ]

Arguments

[ @msx_server_name = ] N'msx_server_name'

The name of the multiserver administration (master) server. @msx_server_name is sysname, with no default.

[ @location = ] N'location'

The location of the target server to add. @location is nvarchar(100), with a default of NULL.

Return code values

0 (success) or 1 (failure).

Result set

None.

Permissions

Permissions to execute this procedure default to members of the sysadmin fixed server role.

Examples

The following example enlists the current server into the AdventureWorks1 master server. The location for the current server is Building 21, Room 309, Rack 5.

USE msdb;
GO

EXECUTE dbo.sp_msx_enlist N'AdventureWorks1', N'Building 21, Room 309, Rack 5';
GO

Related content