Share via

ServerRoles Collection

  • Article

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 ServerRoles collection contains ServerRole objects that enumerate the security administration units used to configure instance-affecting permissions.

SQL-DMO object model that shows the current object

Properties

Count Property

 

Methods

Item Method

Refresh Method

Remarks

Microsoft SQL Server defines a fixed number of instance-affecting security administration units, called server roles. Because the number is fixed, the ServerRoles collection has fixed membership and does not support the Add or Remove methods.

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

Set oServerRole = oSQLServer.ServerRoles("sysadmin")

Or:

Set oServerRole = oSQLServer.ServerRoles(2)