使用 Windows PowerShell 部署网络控制器

本主题提供有关使用 Windows PowerShell 在运行 Windows Server 2019 或 2016 的一台或多台虚拟机 (VM) 上部署网络控制器的说明。

本主题包含以下各节：

• 安装网络控制器服务器角色

• 配置网络控制器群集

• 配置网络控制器应用程序

• 网络控制器部署验证

• 用于网络控制器的其他 Windows PowerShell 命令

• 示例网络控制器配置脚本

• 非 Kerberos 部署的部署后步骤

安装网络控制器服务器角色

可以使用此过程可在虚拟机 (VM) 上安装网络控制器服务器角色。

Administrators组成员或同等身份是执行此过程的最低要求。

若要使用 Windows PowerShell 安装网络控制器，请在 Windows PowerShell 提示符处键入以下命令，然后按 Enter。

Install-WindowsFeature -Name NetworkController -IncludeManagementTools

安装网络控制器需要重启计算机。 为此，请键入以下命令，然后按 Enter。

Restart-Computer

配置网络控制器群集

网络控制器群集为网络控制器应用程序提供高可用性和可伸缩性，可以在创建群集后进行配置并托管在群集之上。

可以通过创建节点对象并配置群集来创建网络控制器群集。

创建节点对象

需要为每个作为网络控制器群集成员的 VM 创建节点对象。

若要创建节点对象，请在 Windows PowerShell 命令提示符处键入以下命令，然后按 Enter。 确保为每个参数添加适用于部署的值。

New-NetworkControllerNodeObject -Name <string> -Server <String> -FaultDomain <string>-RestInterface <string> [-NodeCertificate <X509Certificate2>]

下表提供 New-NetworkControllerNodeObject 命令的每个参数的说明。

配置群集

若要配置群集，请在 Windows PowerShell 命令提示符处键入以下命令，然后按 Enter。 确保为每个参数添加适用于部署的值。

Install-NetworkControllerCluster -Node <NetworkControllerNode[]> -ClusterAuthentication <ClusterAuthentication> [-ManagementSecurityGroup <string>][-DiagnosticLogLocation <string>][-LogLocationCredential <PSCredential>] [-CredentialEncryptionCertificate <X509Certificate2>][-Credential <PSCredential>][-CertificateThumbprint <String>] [-UseSSL][-ComputerName <string>][-LogSizeLimitInMBs<UInt32>] [-LogTimeLimitInDays<UInt32>]

下表提供 Install-NetworkControllerCluster 命令的每个参数的说明。

配置网络控制器应用程序

若要配置网络控制器应用程序，请在 Windows PowerShell 命令提示符处键入以下命令，然后按 Enter。 确保为每个参数添加适用于部署的值。

Install-NetworkController -Node <NetworkControllerNode[]> -ClientAuthentication <ClientAuthentication>  [-ClientCertificateThumbprint <string[]>]  [-ClientSecurityGroup <string>] -ServerCertificate <X509Certificate2> [-RESTIPAddress <String>] [-RESTName <String>] [-Credential <PSCredential>][-CertificateThumbprint <String> ] [-UseSSL]

下表提供 Install-NetworkController 命令的每个参数的说明。

完成网络控制器应用程序的配置后，网络控制器的部署已完成。

网络控制器部署验证

若要验证网络控制器部署，可以将凭据添加到网络控制器，然后检索该凭据。

如果使用 Kerberos 作为 ClientAuthentication 机制，则创建的 ClientSecurityGroup 中的成员身份是执行此过程所需的最低要求。

过程：

1. 在客户端计算机上，如果使用 Kerberos 作为 ClientAuthentication 机制，请使用一个属于 ClientSecurityGroup 成员的用户帐户登录。

2. 打开 Windows PowerShell，键入以下命令以将凭据添加到网络控制器，然后按 Enter。 确保为每个参数添加适用于部署的值。

   $cred=New-Object Microsoft.Windows.Networkcontroller.credentialproperties
   $cred.type="usernamepassword"
   $cred.username="admin"
   $cred.value="abcd"
   
   New-NetworkControllerCredential -ConnectionUri https://networkcontroller -Properties $cred -ResourceId cred1
   

3. 若要检索添加到网络控制器中的凭据，请键入以下命令，然后按 Enter。 确保为每个参数添加适用于部署的值。

   Get-NetworkControllerCredential -ConnectionUri https://networkcontroller -ResourceId cred1
   

4. 查看命令输出，该输出应类似于以下示例输出。

   Tags                   :
   ResourceRef     : /credentials/cred1
   CreatedTime    : 1/1/0001 12:00:00 AM
   InstanceId        : e16ffe62-a701-4d31-915e-7234d4bc5a18
   Etag                  : W/"1ec59631-607f-4d3e-ac78-94b0822f3a9d"
   ResourceMetadata :
   ResourceId       : cred1
   Properties       : Microsoft.Windows.NetworkController.CredentialProperties
   

   注意

   运行 Get-NetworkControllerCredential 命令时，可以使用点运算符列出凭据的属性，从而将该命令的输出分配给变量。 例如 $cred.Properties。

用于网络控制器的其他 Windows PowerShell 命令

部署网络控制器之后，可以使用 Windows PowerShell 命令管理和修改部署。 以下是可以对部署进行的一些更改。

• 修改网络控制器节点、群集和应用程序设置

• 删除网络控制器群集和应用程序

• 管理网络控制器群集节点，包括添加、删除、启用和禁用节点。

下表提供了可用于完成这些任务的 Windows PowerShell 命令的语法。

示例网络控制器配置脚本

以下示例配置脚本演示如何创建多节点网络控制器群集并安装网络控制器应用程序。 此外，$cert 变量会从本地计算机证书存储中选择与使用者名称字符串“networkController.contoso.com”匹配的证书。

$a = New-NetworkControllerNodeObject -Name Node1 -Server NCNode1.contoso.com -FaultDomain fd:/rack1/host1 -RestInterface Internal
$b = New-NetworkControllerNodeObject -Name Node2 -Server NCNode2.contoso.com -FaultDomain fd:/rack1/host2 -RestInterface Internal
$c = New-NetworkControllerNodeObject -Name Node3 -Server NCNode3.contoso.com -FaultDomain fd:/rack1/host3 -RestInterface Internal

$cert= get-item Cert:\LocalMachine\My | get-ChildItem | where {$_.Subject -imatch "networkController.contoso.com" }

Install-NetworkControllerCluster -Node @($a,$b,$c)  -ClusterAuthentication Kerberos -DiagnosticLogLocation \\share\Diagnostics - ManagementSecurityGroup Contoso\NCManagementAdmins -CredentialEncryptionCertificate $cert
Install-NetworkController -Node @($a,$b,$c) -ClientAuthentication Kerberos -ClientSecurityGroup Contoso\NCRESTClients -ServerCertificate $cert -RestIpAddress 10.0.0.1/24

非 Kerberos 部署的部署后步骤

如果未将 Kerberos 用于网络控制器部署，则必须部署证书。

有关详细信息，请参阅网络控制器的部署后步骤。