New-SCVMHostProfile

モジュール:

VirtualMachineManager

ホスト プロファイルを作成します。

構文

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

応答ファイルとして使用する仮想マシン マネージャー (VMM) ライブラリに格納されているスクリプト オブジェクトを指定します。 応答ファイル スクリプトの名前は、仮想マシンにインストールするオペレーティング システムによって異なります。

• Sysprep.inf。 Windows XP、Windows Server 2000、または Windows Server 2003
• Unattend.xml。 Windows Vista、Windows 7、または Windows Server 2008

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

-Baseline

ベースライン オブジェクトの配列を指定します。

Type:	Baseline[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BypassVHDConversion

ホスト プロファイルにアタッチされた動的 VHD が、デプロイ中に固定の種類に変換されないかどうかを示します。

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

-CodeIntegrityPolicy

コード整合性ポリシーを指定します。

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

-ComputerAccessRunAsAccount

コンピューターの展開に使用するコンピューター アクセス実行アカウントを指定します。 この実行アカウントは、ローカル管理者としてコンピューターに追加され、コンピューターの管理に使用されます。

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

-Description

ホスト プロファイルの説明を指定します。

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

-DiskConfiguration

Windows Hyper-V で展開する物理コンピューターのディスクとパーティションの構成を指定します。

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

-Domain

Active Directory ドメインの完全修飾ドメイン名 (FQDN) を指定します。

形式の例: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

指定したドメインに参加するアクセス許可を持つ実行アカウントを指定します。

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

-DriverMatchingTag

展開時にドライバーのプロパティと一致するカスタム タグを指定します。 タグを指定すると、展開プロセスは、ホスト プロファイルで指定されたタグとドライバー内のタグを照合して、一致するドライバーをダウンロードし、ターゲット イメージにインストールします。

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FullName

バーチャル マシンの登録ユーザーの名前を指定します。

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

-GuiRunOnceCommands

無人応答ファイルの [GuiRunOnce] セクションに追加するコマンドの配列を指定します。 二重引用符で囲まれた各文字列の周りに単一引用符を使用します。

形式の例: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Windows PowerShellで引用符を使用する方法については、「.」と入力しますGet-Help about_Quoting_Rules。

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

-IsGuarded

ホストが保護されたホストである必要があることを示します。

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

-JobGroup

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

Type:	Guid
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

-JoinWorkgroup

この操作がワークグループに参加することを示します。

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

-LocalAdministratorCredential

ローカル管理者アカウント (Linux 互換のゲスト オペレーティング システム プロファイルの場合は Linux ルート アカウント) のユーザー名とパスワードを指定します。

新規または既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシンで資格情報を指定すると、既存の管理者パスワードがオーバーライドされます。

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

-Name

VMM オブジェクトの名前を指定します。

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

-OrganizationName

仮想マシンが登録されているユーザーの組織の名前を指定します。

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

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

• 形式の例: -Owner "Contoso\PattiFuller"
• 形式の例: -Owner "PattiFuller@Contoso"

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

-ProductKey

プロダクト キーを指定します。 プロダクト キーは製品のライセンスを識別する 25 桁の番号です。 プロダクト キーを使用して、VMM または仮想マシンまたはホストにインストールされるオペレーティング システムを登録できます。

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

-TimeZone

同じ標準時間を共有する地理的リージョンを識別する数値 (インデックス) を指定します。 タイム ゾーン インデックスの一覧については、「Microsoft タイム ゾーン インデックスの値http://go.microsoft.com/fwlink/?LinkId=120935」を参照してください。 タイム ゾーンが指定されていない場合、仮想マシンに使用される既定のタイム ゾーンは、仮想マシン ホスト上にあるのと同じタイム ゾーン設定になります。

GMT 標準タイム ゾーンを指定する形式の例: -TimeZone 085

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

-VirtualHardDisk

バーチャル ハード ディスク オブジェクトを指定します。

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

-VMHostNetworkAdapterProfile

ホスト ネットワーク アダプター プロファイル オブジェクトを指定します。

Type:	PhysicalComputerNetworkAdapterProfile[]
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:	True
Accept wildcard characters:	False

-VMPaths

バーチャル マシン ファイルが保管されるホスト上の既定のパス セットを指定します (各パスの文字列はパイプライン演算子で区切ります)。

形式の例: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

出力

HostProfile

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

関連リンク

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