New-SCVMHostProfile

構文

New-SCVMHostProfile
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCVMHostProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   [-JoinWorkgroup]
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCVMHostProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCVMHostProfile コマンドレットは、ホスト プロファイルを作成します。 ホスト プロファイルには、Hyper-V ホストとして物理コンピューターを展開するために使用されるハードウェアとオペレーティング システムの構成設定が含まれています。

ホスト プロファイルを作成する前に、指定した仮想ハード ディスク ドライブ (.vhd) ファイルがライブラリ共有に存在することを確認します。

例

例 1: ホスト プロファイルを作成する

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfile

最初のコマンドは、VHD01.vhd という名前の仮想ハード ディスク オブジェクトを取得し、そのオブジェクトを $VHD 変数に格納します。

2 番目のコマンドでは、資格情報の入力を求められます。 プロンプトで、管理者アカウントの資格情報を入力します。 このコマンドは、資格情報を $Credential 変数に格納します。

3 番目のコマンドは、$VHDに格納されている仮想ハード ディスクと、$Credentialに格納されている資格情報を使用して HostProfile01 という名前のホスト プロファイルを作成します。

最後のコマンドは、新しく作成されたホスト プロファイルに関する情報をユーザーに表示します。

例 2: 既存のホスト プロファイルを複製する

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

最初のコマンドは、HostProfile01 という名前のホスト プロファイル オブジェクトを取得し、そのオブジェクトを $OrigHostProfile 変数に格納します。

2 番目のコマンドは、$OrigHostProfileに格納されているホスト プロファイルをコピーし、指定した名前を指定して、新しいプロファイル オブジェクトを$NewHostProfile変数に格納します。

例 3: ホスト ネットワーク アダプター プロファイルを含むホスト プロファイルを作成する

PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProf

最初のコマンドは、VHDX01.vhdx という名前の仮想ハード ディスク オブジェクトを取得し、$VHDX変数にオブジェクトを格納します。

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

3 番目のコマンドは、ユーザーにローカル管理者の資格情報の入力を求め、指定された資格情報を $LocalAdminCreds 変数に格納します。

4 番目のコマンドは、ID が 259f47c7-c5a9-429d-a421-d232f9b34991 のホスト ネットワーク アダプター プロファイル オブジェクトを取得し、$HostNetAdapterProf変数にオブジェクトを格納します。

最後のコマンドでは、VHDX01 と、$HostNetAdapterProfに格納されているホスト ネットワーク アダプター プロファイルを使用して、ホスト プロファイル 03 という名前のホスト プロファイルを作成します。

パラメーター

-AnswerFile

-Baseline

-BypassVHDConversion

-CodeIntegrityPolicy

-ComputerAccessRunAsAccount

-Description

-DiskConfiguration

-Domain

-DomainJoinRunAsAccount

-DriverMatchingTag

-FullName

-GuiRunOnceCommands

-IsGuarded

-JobGroup

-JobVariable

-JoinWorkgroup

-LocalAdministratorCredential

-Name

-OrganizationName

-Owner

-ProductKey

-PROTipID

-RunAsynchronously

-TimeZone

-VirtualHardDisk

-VMHostNetworkAdapterProfile

-VMHostProfile

-VMMServer

-VMPaths

出力

HostProfile

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

関連リンク

• Get-SCRunAsAccount
• Get-SCVirtualHardDisk
• Get-SCVMHostNetworkAdapterProfile
• Get-SCVMHostProfile
• Remove-SCVMHostProfile
• Set-SCVMHostProfile