sys-fn-virtualservernodes-transact-sql.md

description	sys.fn_virtualservernodes (Transact-SQL)
title	sys.fn_virtualservernodes (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql
ms.prod_service	database-engine, pdw
ms.reviewer
ms.technology	system-objects
ms.topic	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
author	rwestMSFT
ms.author	randolphwest
monikerRange	>=aps-pdw-2016||>=sql-server-2016||>=sql-server-linux-2017||=azuresqldb-mi-current

sys.fn_virtualservernodes (Transact-SQL)

[!INCLUDE sql-asdbmi-pdw]

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.

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)