Get-NetworkControllerNode

Gets the network controller node settings.

Syntax

Get-NetworkControllerNode
   [-Name <String>]
   [-ComputerName <String>]
   [-UseSsl]
   [-Credential <PSCredential>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Description

The Get-NetworkControllerNode cmdlet gets the network controller node settings such as the node name, fully qualified domain name (FQDN), IP address, fault domain, representational state transfer (REST) interface of the node, and the node certificate, if applicable.

Examples

Example 1: Get all network controller nodes in a deployment

PS C:\> Get-NetworkControllerNode
Name            : Node1
Server          : NCNode1.contoso.com
FaultDomain     : fd:/host1/node1
RestInterface   : Ethernet
NodeCertificate : 
Status          : Up
Name            : Node2
Server          : NCNode2.contoso.com
FaultDomain     : fd:/host2/node2
RestInterface   : Ethernet
NodeCertificate : 
Status          : Up
Name            : Node3
Server          : NCNode3.contoso.com
FaultDomain     : fd:/host3/node3
RestInterface   : Ethernet
NodeCertificate : 
Status          : Up

This command gets the network controller node settings for all nodes in the deployment.

Example 2: Get network controller node settings for a specified node by name

PS C:\> Get-NetworkControllerNode -Name "Node1"
Node1Name       : Node1
Server          : NCNode1.contoso.com
FaultDomain     : fd:/host1/node1
RestInterface   : Ethernet
NodeCertificate : 
Status          : Up

This command gets the network controller node settings for a specific node named Node1.

Parameters

-CertificateThumbprint

Specifies the digital public key X.509 certificate of a user account that has permission to perform this action. This is the certificate thumbprint of the certificate. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Specifies the name of the network controller node on which this cmdlet operates.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifies a user credential that has permission to perform this action. The default is the current user. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the friendly name of the node for the network controller. If not provided, settings are retrieved for all nodes in the deployment.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseSsl

Indicates that the remote computer uses the Secure Sockets Layer (SSL) protocol to establish a connection to the Network Controller node. The default value of this parameter is false. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

This cmdlet returns an object that contains the following fields:

  • Name of the node
  • Hostname, FQDN, or IP address of the node
  • Fault domain of the node
  • Name of interface to be used for REST operations on the node
  • Node certificate