Windows PowerShell を使用してネットワーク コントローラーを展開する

このトピックでは、Windows Server 2019 または 2016 が稼働している 1 台または複数台の仮想マシン (VM) にネットワーク コントローラーを展開するために、Windows PowerShell を使用する方法について説明します。

このトピックは、次のセクションで構成されています。

• ネットワーク コントローラー サーバー ロールのインストール

• ネットワーク コントローラー クラスターの構成

• ネットワーク コントローラー アプリケーションの構成

• ネットワーク コントローラーの展開の検証

• ネットワーク コントローラー用の追加の Windows PowerShell コマンド

• ネットワーク コントローラーのサンプル構成スクリプト

• 非 Kerberos 展開における展開後の手順

ネットワーク コントローラー サーバー ロールのインストール

仮想マシン (VM) にネットワーク コントローラー サーバー ロールをインストールするには、次の手順を行います。

Membership in Administrators, or equivalent, is the minimum required to perform this procedure.

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>]

The following table provides descriptions for each parameter of the New-NetworkControllerNodeObject command.

クラスターを構成する

クラスターを構成するには、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>]

The following table provides descriptions for each parameter of the Install-NetworkControllerCluster command.

ネットワーク コントローラー アプリケーションの構成

ネットワーク コントローラー アプリケーションを構成するには、Windows PowerShell コマンド プロンプトで次のコマンドを入力してから、Enter キーを押します。 パラメーターごとに、展開に適した値を確実に追加します。

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

The following table provides descriptions for each parameter of the Install-NetworkController command.

ネットワーク コントローラー アプリケーションの構成が完了したら、ネットワーク コントローラーの展開が完了します。

ネットワーク コントローラーの展開の検証

ネットワーク コントローラーの展開を検証するには、ネットワーク コントローラーに資格情報を追加し、その資格情報を取得します。

If you are using Kerberos as the ClientAuthentication mechanism, membership in the ClientSecurityGroup that you created is the minimum required to perform this procedure.

Procedure:

1. On a client computer, if you are using Kerberos as the ClientAuthentication mechanism, log on with a user account that is a member of your 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
   

   Note

   When you run the Get-NetworkControllerCredential command, you can assign the output of the command to a variable by using the dot operator to list the properties of the credentials. たとえば、$cred.Properties とします。

ネットワーク コントローラー用の追加の Windows PowerShell コマンド

ネットワーク コントローラーを展開したら、Windows PowerShell コマンドを使用して、展開を管理および変更できます。 展開に加えることができる変更の一部を次に示します。

• ネットワーク コントローラー ノード、クラスター、およびアプリケーション設定を変更する

• ネットワーク コントローラー クラスターおよびアプリケーションを削除する

• ネットワーク コントローラー クラスター ノードを管理する (ノードの追加、削除、有効化、無効化など)

次の表に、これらのタスクを達成するために使用できる Windows PowerShell コマンドの構文を指定します。

ネットワーク コントローラーのサンプル構成スクリプト

次のサンプル構成スクリプトは、マルチノード ネットワーク コントローラー クラスターを作成し、ネットワーク コントローラー アプリケーションをインストールする方法を示しています。 さらに、サブジェクト名文字列 "networkController.contoso.com" に一致する証明書がローカル コンピューターの証明書ストアから、$cert 変数によって選択されます。

$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 を使用していない場合は、証明書を展開する必要があります。

詳細については、「ネットワーク コントローラーの展開後の手順」を参照してください。