• Article

RegisteredServers Collection

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The RegisteredServers collection contains RegisteredServer objects that expose the attributes of a single registry-listed instance of Microsoft SQL Server.

SQL-DMO object model that shows the current object

Properties

Count Property

Remarks

SQL Distributed Management Objects (SQL-DMO) applications can maintain lists of some or all of instances of SQL Server in an organization. The lists are stored in the registry of the operating system.

With the RegisteredServers collection, you can:

  • Create a Windows registry entry that lists an instance of SQL Server by SQL Server name.

  • Remove a Windows registry entry listing an instance of SQL Server.

For more information about creating registry entries that organize instances of SQL Server, see the RegisteredServer Objectsection.

To remove a registry entry that lists an instance of SQL Server

  • Use the Remove method of the RegisteredServers collection, as in:

    oApplication.RegisteredServers.Remove("SEATTLE1")

When using the Item or Remove method, the RegisteredServers collection supports member identification using either name or ordinal reference syntax. For example:

Set oRegisteredServer = oApplication.RegisteredServers("LONDON2")

Or:

Set oRegisteredServer = oApplication.RegisteredServers(2)