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 |
Inputs
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
Related Links
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기