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 モジュールを作成することもできます。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCCustomConfigurationProvider

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

Type:ConfigurationProvider
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCPort

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCProtocol

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

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

形式の例: -BMCProtocol "Custom"

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

Type:OutOfBandManagementType
Accepted values:None, IPMI, SMASH, Custom
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCRunAsAccount

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

Type:RunAsAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BypassADMachineAccountCheck

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetwork

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

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementAdapterMACAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SMBiosGuid

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

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

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

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostConfig

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

Type:PhysicalComputerConfig
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

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

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostProfile

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

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

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

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

Host

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

メモ

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