fn_virtualservernodes (Transact-SQL)

  • Article

Returns a list of failover clustered instance nodes on which an instance of SQL Server can run. This information is useful in failover clustering environments.

Important

This Microsoft SQL Server 2000 system function is included for backward compatibility. We recommend that you use sys.dm_os_cluster_nodes instead.

Syntax

fn_virtualservernodes()

Tables Returned

If the current server is a clustered server, fn_virtualservernodes returns a list of failover clustered instance nodes on which this instance of SQL Server has been defined.

If the current server instance is not a clustered server, fn_virtualservernodes returns an empty rowset.

Permissions

The user must have VIEW SERVER STATE permission for the instance of SQL Server.

Examples

The following example uses fn_virtualservernodes to query on a clustered server instance:

SELECT * FROM fn_virtualservernodes()

This is the result set:

NodeName

--------

SS3-CLUSN1

SS3-CLUSN2

See Also

Reference

sys.dm_os_cluster_nodes
fn_servershareddrives (Transact-SQL)

Help and Information

Getting SQL Server 2005 Assistance

Change History

Release History

17 July 2006
Changed content:
  • Added note about deprecation, link to sys.dm_os_cluster_nodes topic.
  • Permissions are at the instance level, not the server level.
  • Updated node names in the result set.