SCVMM 2016 UR5 で利用可能なコマンドレット (Install-SCVMHostCluster) について

スポンサーリンク
Microsoft Public Affiliate Program (JP)

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Install-SCVMHostCluster コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Install-SCVMHostCluster」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Install-SCVMHostCluster コマンドレット

名前

Install-SCVMHostCluster

概要

VMM によって管理されている Hyper-V ホストからフェールオーバー クラスターを作成します。

構文

Install-SCVMHostCluster
 [-ClusterIPAddress <String[]>]
 [-ClusterIPAddressPool <StaticIPAddressPool[]>]
 -ClusterName <String>
 [-ClusterReserve <Int32>]
 -Credential <VMMCredential>
 [-Description <String>]
 [-EnableS2D]
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RunAsynchronously]
 [-SetQuorumDisk <ClientObject>]
 [-SetQuorumNodeMajority]
 [-SkipValidation]
 -VMHost <Host[]>
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Install-SCVMHostCluster
 [-ClusterIPAddress <String[]>]
 [-ClusterIPAddressPool <StaticIPAddressPool[]>]
 -ClusterName <String>
 [-ClusterReserve <Int32>]
 -Credential <VMMCredential>
 [-Description <String>]
 [-EnableS2D]
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 -PhysicalComputerConfig <PhysicalComputerConfig[]>
 [-RunAsynchronously]
 [-SetQuorumNodeMajority]
 [-SkipValidation]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Install-SCVMHostCluster
 -Credential <VMMCredential>
 [-EnableS2D]
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 -PhysicalComputerConfig <PhysicalComputerConfig[]>
 [-RunAsynchronously]
 [-SkipValidation]
 -VMHostCluster <HostCluster>
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Install-SCVMHostCluster
 -Credential <VMMCredential>
 [-EnableS2D]
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RunAsynchronously]
 [-SkipValidation]
 -VMHost <Host[]>
 -VMHostCluster <HostCluster>
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

説明

Install-SCVMHostCluster コマンドレットは、Virtual Machine Manager (VMM) によって管理されている Hyper-V ホストからフェールオーバー クラスターを作成します。Install-SCVMHostCluster は、既存のクラスターにノードを追加することも可能です。

パラメーター

-ClusterIPAddress <String[]>

クラスター IP アドレスとして使用する複数の IP アドレスを指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-ClusterIPAddressPool <StaticIPAddressPool[]>

クラスター IP アドレス プールとして使用する静的 IP アドレスプールを指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-ClusterName <String>

クラスター名を指定します。

必須 true
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-ClusterReserve <Int32>

VMM がクラスターを過負荷として指定する前に、ホスト クラスターが保持可能なホスト障害数を指定します。既定値は 1 です。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-Credential <VMMCredential>

資格情報オブジェクトもしくは一部のコマンドレットで、この操作を実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む Run As アカウント オブジェクトを指定します。もしくは、Restart-SCJob の場合、再起動したタスクを完了するためのアクセス許可が必要となります。

PSCredential オブジェクトに関する詳細な情報は、Get-Help Get-Credential を実行します。. Run As アカウントに関する詳細な情報は、Get-Help New-SCRunAsAccount を実行します。

必須 true
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-Description <String>

ホスト クラスターに対する説明を指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-EnableS2D [<SwitchParameter>]

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-JobGroup <Guid>

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に、一連のコマンドを実行する一連のコマンドの識別子を指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-JobVariable <String>

ジョブの進行状況を追跡し、このパラメーターで指定された変数に格納する場合に指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-PROTipID <Guid>

このアクションにトリガーされるパフォーマンスとリソースの最適化のヒント (PRO ヒント) を指定します。このパラメーターは、PRO ヒントを監査することができます。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-PhysicalComputerConfig <PhysicalComputerConfig[]>

ホスト構成オブジェクト配列を指定します。

ホスト構成オブジェクトに関する情報は、New-SCVMHostConfig コマンドレットを参照してください。

必須 true
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-RunAsynchronously [<SwitchParameter>]

ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-SetQuorumDisk <ClientObject>

クラスターのクォーラム ディスクとして使用するディスクを指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-SetQuorumNodeMajority [<SwitchParameter>]

クラスターのクォーラム モードをノード マジョリティに設定する場合に指定します。

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-SkipValidation [<SwitchParameter>]

クラスター作成時にクラスター検証テストをスキップする場合に指定します。

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-VMHost <Host[]>

仮想マシン ホスト オブジェクトの配列を指定します。

必須 true
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-VMHostCluster <HostCluster>

VMM ホスト クラスター オブジェクトを指定します。

必須 true
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-VMMServer <ServerConnection>

VMM サーバー オブジェクトを取得します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する True (ByValue)
ワイルドカード文字を許可する false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

  • VMHostCluster
    • このコマンドレットは、VMHostCluster オブジェクトを返します。

メモ

例 1 : 管理対象ホストからクラスターを作成する

コマンド
$RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
$HostGroup = Get-SCVMHostGroup -Name "New York"
$Nodes = Get-SCVMHost | where {$_.Name -like "HostClus*" -and $_.VMHostGroup -eq $HostGroup} 
Install-SCVMHostCluster -VMHost $Nodes -ClusterName "Cluster01" -Credential $RunAsAcct
コマンドの説明

最初のコマンドは、Run As アカウント “RunAsAccount01” を取得し、$RunAsAcct 変数に格納します。

2 番目のコマンドは、ホスト グループ オブジェクト “New York” を取得し、オブジェクトを $HostGroup 変数に格納します。

3 番目のコマンドは、$HostGroup に格納されているホスト グループ内の “HostClus” という名前で始まるクラスター ノードを取得します。このコマンドはノードを $Nodes 変数に格納します。

最後のコマンドはクラスターを作成し、”Cluster01″ という名前を付けます。

例 2 : 管理対象ホストからハイパー コンバージド クラスターを作成する

コマンド
$RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
$HostGroup = Get-SCVMHostGroup -Name "New York"
$Nodes = Get-SCVMHost | where {$_.Name -like "HostClus*" -and $_.VMHostGroup -eq $HostGroup} 
Install-SCVMHostCluster -VMHost $Nodes -ClusterName "Cluster01" -Credential $RunAsAcct -EnableS2D
コマンドの説明

最初のコマンドは、Run As アカウント “RunAsAccount01” を取得し、$RunAsAcct 変数に格納します。

2 番目のコマンドは、ホスト グループ オブジェクト “New York” を取得し、$HostGroup 変数に格納します。

3 番目のコマンドは、$ HostGroupに 格納されているホストグループ内の “HostClus” という名前で始まるクラスター ノードを取得します。このコマンドはノードを $Nodes 変数に格納します。

最後のコマンドは、ハイパー コンバージド クラスターを作成し、”Cluster01″ という名前を付けます。

関連するリンク

  • Add-SCVMHostCluster
  • Get-SCVMHostCluster
  • Move-SCVMHostCluster
  • Read-SCVMHostCluster
  • Remove-SCVMHostCluster
  • Set-SCVMHostCluster
  • Test-SCVMHostCluster
  • Uninstall-SCVMHostCluster

参考