fn_virtualservernodes (Transact-SQL)

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 MicrosoftSQL Server 2000 system function is included for backward compatibility. We recommend that you use sys.dm_os_cluster_nodes (Transact-SQL) instead.

Topic link iconTransact-SQL Syntax Conventions

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()

Here is the result set.

NodeName

--------

SS3-CLUSN1

SS3-CLUSN2