New-SCVMHost

ホスト プロファイルで定義されているプロパティを使用して、物理コンピューターから VMM ホストを作成します。

構文

New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHost
   [-VMMServer <ServerConnection>]
   -VMHostConfig <PhysicalComputerConfig>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   -BMCAddress <String>
   -BMCRunAsAccount <RunAsAccount>
   [-BMCPort <UInt32>]
   -BMCProtocol <OutOfBandManagementType>
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCVMHost コマンドレットは、ホスト プロファイルで定義されているプロパティを使用して、物理コンピューターから仮想マシン マネージャー (VMM) ホストを作成します。 物理コンピューターには帯域外コントローラーが必要です。

ホストを作成する前に、PXE サーバーが VMM に追加されていること、ホスト プロファイルが作成されていること、および必要なドライバー ファイルがライブラリに追加されていることを確認します。 注: VMM に追加する PXE サーバーは、マネージド Hyper-V ホストに変換する物理コンピューターと同じサブネットに存在する必要があります。

VMM でサポートされるホストの種類の詳細については、「Get-Help Add-SCVMHost -Detailed」と入力します。

例 1: DHCP ベースのホスト プロファイルを使用して物理コンピューターからホストを作成する

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -ComputerName "NewHost01" -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ManagementAdapterMACAddress "00-1D-D8-B7-1C-00" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.91"

最初のコマンドは、BMCRunAsAcct という名前の実行アカウント オブジェクトを取得し、$BMCRAA変数にオブジェクトを格納します。

2 番目のコマンドは、$BMCRAAで指定された実行アカウントを使用して、IP アドレスが 10.10.0.1 の物理コンピューターを検出します。 次に、物理コンピューターを $NewPhysicalComputer 変数に格納します。

3 番目のコマンドは、HostGroup01 という名前のホスト グループ オブジェクトを取得し、$HostGroup変数にオブジェクトを格納します。

4 番目のコマンドは、HostProfile01 という名前のホスト プロファイル オブジェクトを取得し、そのオブジェクトを $HostProfile 変数に格納します。 HostProfile01 は、DHCP サービスを介して IP アドレスを取得するように構成されています。

最後のコマンドでは、$HostProfileに格納されているホスト プロファイルを使用して、$NewPhysicalComputerに格納されている物理コンピューターからホストを作成し、NewHost01 という名前を付けます。

例 2: 静的 IP ベースのホスト プロファイルを使用して物理コンピューターからホストを作成する

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ComputerName "NewHost02" -ManagementAdapterMACAddress "00-18-8B-0A-4D-76" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.1.1/24" -IPAddress "192.168.1.101"

最初のコマンドは、BMCRunAsAccount という名前の実行アカウント オブジェクトを取得し、$BMCRAA変数にオブジェクトを格納します。

2 番目のコマンドは、$BMCRAAに格納されている実行アカウントを使用して、アドレス 10.10.0.1 のコンピューターを検出し、$NewPhysicalComputer変数にコンピューターを格納します。

3 番目のコマンドは、HostGroup01 という名前のホスト グループ オブジェクトを取得し、$HostGroup変数にオブジェクトを格納します。

4 番目のコマンドは、HostProfile02 という名前のホスト プロファイル オブジェクトを取得し、そのオブジェクトを $HostProfile 変数に格納します。 HostProfile02 は、静的 IP アドレスを割り当てるために構成されます。

最後のコマンドでは、$HostProfileに格納されているホスト プロファイルを使用して、$NewPhysicalComputerに格納されている物理コンピューターからホストを作成し、NewHost02 という名前を付けて、MAC アドレス、IPAddress、サブネットを構成します。

例 3: 新しいホスト プロファイルを使用して既存のホストを再デプロイする

PS C:\> $BMCRaa = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $OldHost = Get-SCVMHost "NewHost02"
PS C:\> $OldBMCIP = $OldHost.physicalmachine.BMCAddress
PS C:\> $OldBMCProtocol = $OldHost.physicalmachine.BMCType
PS C:\> $OldComputer = Find-SCComputer -BMCAddress $OldBMCIP -BMCRunAsAccount $BMCRAA -BMCProtocol $OldBMCProtocol
PS C:\> $OldGuid = $OldComputer.SMBIOSGUID
PS C:\> $OldAdapter = Get-SCVMHostNetworkAdapter -VMHost $OldHost
PS C:\> $OldMAC = $OldAdapter[0].macaddress
PS C:\> $OldRAA = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Remove-SCVMHost $OldHost -Credential $OldRAA
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $NewHostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $NewHostGroup -VMHostProfile $NewHostProfile  -BMCAddress $OldBMCIP -BMCRunAsAccount $BMcRAA -BMCProtocol $OldBMCProtocol -SMBIOSGUID $OldGUID -ManagementAdapterMACAddress $OldMAC -ComputerName "Computer01" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.93"

最初のコマンドは、BMCRunAsAccount という名前の実行アカウント オブジェクトを取得し、$BMCRaa変数にオブジェクトを格納します。

次の 8 つのコマンドは、再デプロイするホストのプロパティを保存します。

10 番目のコマンドは、VMM から古いホストを削除します。

11 番目のコマンドは、New HostGroup01 という名前のホスト グループ オブジェクトを取得し、$NewHostGroup変数にオブジェクトを格納します。

12 番目のコマンドは、HostProfile02 という名前のホスト プロファイル オブジェクトを取得し、$NewHostProfile変数にオブジェクトを格納します。

最後のコマンドは、ホストを識別する以前の設定を使用して古いホストを再デプロイしますが、新しいホストが ($NewHostGroupに格納されている) と更新されたプロファイル設定 ($NewHostProfileに格納) に再デプロイされます。

パラメーター

-BMCAddress

特定の物理マシンの帯域外ベースボード管理コントローラー (BMC) アドレスを指定または更新します。 これは、IP アドレス、完全修飾ドメイン名 (FQDN)、または DNS プレフィックス (通常は NetBIOS 名と同じ名前) です。

通常、BMC アドレスとそのネットワークへの接続は、標準のネットワーク アダプターに関連付けられている IP アドレスとは別です。 または、一部のコンピューターでは、標準のネットワーク アダプターを使用して、BMC とネットワーク アダプターの 1 つのアドレスを指定します。 ただし、BMC アドレスには一意のポートがあるため、ネットワーク上で一意に識別できます。

  • IPv4 形式の例: -BMCAddress "10.0.0.21"
  • Ipv6 形式の例: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • FQDN 形式の例: -BMCAddress "Computer01.Contoso.com"
  • NetBIOS 形式の例: -BMCAddress "Computer01"

注: 既定では、VMM は BMCAddress に IP アドレスまたは FQDN を使用します。 ただし、BMC アドレスとして他の種類のアドレスを指定できる Windows PowerShell モジュールを作成することもできます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCCustomConfigurationProvider

ベースボード管理コントローラー (BMC) の構成プロバイダー オブジェクトを指定または更新します。 構成プロバイダーは、VMM PowerShell コマンドをベースボード管理コントローラーの種類に固有の API 呼び出しに変換する VMM へのプラグインです。 このパラメーターは、カスタム BMCProtocol と共に使用する必要があります。

型:ConfigurationProvider
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCPort

特定の物理マシンの帯域外ベースボード管理コントローラー (BMC) ポートを指定または更新します。 BMC ポートは、サービス プロセッサ ポートとも呼ばれます。 既定のポートの例は、IPMI の場合は 623、WS-Man 経由の SSA の場合は 443 です。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCProtocol

VMM が帯域外ベースボード管理コントローラー (BMC) との通信に使用するプロトコルを指定または更新します。 有効な値は、IPMI、SMASH、Custom です。

BMC (サービス プロセッサまたは管理コントローラーとも呼ばれます) は、ハードウェアとシステム管理ソフトウェアの間のインターフェイスを機能するサーバーのマザーボード上の特殊なコントローラーです。 物理マシンのマザーボードに BMC が含まれている場合、マシンが接続されている場合 (電源がオフか電源オンか、オペレーティング システムがインストールされているかどうか)、システム ハードウェアとそのシステム ハードウェアの正常性の状態に関する情報が使用可能になります。

形式の例: -BMCProtocol "Custom"

注: カスタム プロトコルでは、BMCCustomConfigurationProvider パラメーターを使用する必要があります。

型:OutOfBandManagementType
指定可能な値:None, IPMI, SMASH, Custom
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCRunAsAccount

ベースボード管理コントローラー (BMC) デバイスで使用する実行アカウントを指定します。

型:RunAsAccount
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BypassADMachineAccountCheck

このコマンドレットが、Active Directory に既に存在するコンピューター アカウントを再利用することを示します。 既定では、New-SCVMHost は、指定した名前の既存のアカウントが Active Directory でチェックされ、コンピューター アカウントが上書きされないようにします。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ComputerName

VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 このパラメーターに使用できる値は次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

VMM ホストの説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IPAddress

IPv4 または IPv6 アドレスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LogicalNetwork

論理ネットワークを指定します。 論理ネットワークは、ネットワーク割り当てを整理および簡素化するために使用される IP サブネットと VLAN の名前付きグループです。

型:LogicalNetwork
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ManagementAdapterMACAddress

VMM サーバーがこのホストと通信するために使用するコンピューター上の物理ネットワーク アダプターの MAC アドレスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SMBiosGuid

VMM でその物理コンピューターのレコードに関連付けられている物理コンピューターのシステム管理 BIOS グローバル一意識別子 (SMBIOS GUID) を指定します。

SMBIOS は、ユーザーまたはアプリケーションが、システム、製造元、システム BIOS のバージョンの名前など、このコンピューター上のハードウェアに関する情報を格納および取得できるようにするデータ構造とアクセス方法を定義します。 Windows は、システムの起動時に SMBIOS データを取得し、そのデータをプログラムで使用できるようにします。

型:Guid
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Subnet

クラスレス Inter-Domain ルーティング (CIDR) 表記の IP サブネット (IPv4 または IPv6) を指定します。

  • IPv4 サブネットの形式の例: 192.168.0.1/24
  • IPv6 サブネットの形式の例: FD4A:29CD:184F:3A2C::/64

注: IP サブネットは、ホスト グループまたは子ホスト グループ内の他のサブネットと重複することはできません。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMHostConfig

物理コンピューター構成オブジェクトを指定します。

型:PhysicalComputerConfig
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMHostGroup

仮想マシン ホスト グループ オブジェクトを指定します。

型:HostGroup
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMHostProfile

仮想マシン ホスト プロファイル オブジェクトを指定します。

型:PhysicalComputerProfile
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VMMServer

VMM サーバー オブジェクトを指定します。

型:ServerConnection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

Host

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

メモ

  • Get-SCVMHostProfile コマンドレットを使用して取得できるホスト プロファイル オブジェクトが必要です。