sys-fn-virtualservernodes-transact-sql.md

title	sys.fn_virtualservernodes (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql-non-specified
ms.reviewer
ms.suite
ms.technology	database-engine
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	fn_virtualservernodes fn_virtualservernodes_TSQL
dev_langs	TSQL
helpviewer_keywords	nodes [Faillover Clustering], virtual servers nodes [Faillover Clustering] virtual servers [Faillover Clustering] failover clustering [SQL Server], nodes fn_virtualservernodes function sys.fn_virtualservernodes function
ms.assetid	257f3b8d-93c0-4444-87f1-ea211bd8cad0
caps.latest.revision	25
author	BYHAM
ms.author	rickbyh
manager	jhubbard

sys.fn_virtualservernodes (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-pdw_md]

Returns a list of failover clustered instance nodes on which an instance of [!INCLUDEssNoVersion] can run. This information is useful in failover clustering environments.

Important

This [!INCLUDEmsCoName][!INCLUDEssSQL11] system function is included for backward compatibility. We recommend that you use sys.dm_os_cluster_nodes (Transact-SQL) instead.

Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssKatmai] through current version).

Transact-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 [!INCLUDEssNoVersion] 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 [!INCLUDEssNoVersion].

Examples

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

SELECT * FROM fn_virtualservernodes();  

[!INCLUDEssResult]

NodeName

--------

SS3-CLUSN1

SS3-CLUSN2

See Also

sys.dm_os_cluster_nodes (Transact-SQL)
sys.fn_servershareddrives (Transact-SQL)