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
応答ファイルとして使用する仮想マシン マネージャー (VMM) ライブラリに格納されているスクリプト オブジェクトを指定します。 応答ファイル スクリプトの名前は、仮想マシンにインストールするオペレーティング システムによって異なります。
- Sysprep.inf。 Windows XP、Windows Server 2000、または Windows Server 2003
- Unattend.xml. Windows Vista、Windows 7、または Windows Server 2008
| 型: | Script |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Baseline
ベースライン オブジェクトの配列
| 型: | Baseline[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-BypassVHDConversion
展開中に、ホスト プロファイルに接続されている動的 VHD が固定の種類に変換されないかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CodeIntegrityPolicy
コード整合性ポリシーを指定します。
| 型: | CodeIntegrityPolicy |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerAccessRunAsAccount
コンピューターの展開に使用するコンピューター アクセス実行アカウントを指定します。 この実行アカウントは、ローカル管理者としてマシンに追加され、マシンの管理に使用されます。
| 型: | RunAsAccount |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
ホスト プロファイルの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DiskConfiguration
Windows Hyper-V で展開する物理コンピューターのディスクとパーティションの構成を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Domain
Active Directory ドメインの完全修飾ドメイン名 (FQDN) を指定します。
形式の例: -Domain "Domain01.Corp.Contoso.com"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DomainJoinRunAsAccount
指定したドメインに参加するアクセス許可を持つ実行アカウントを指定します。
| 型: | RunAsAccount |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DriverMatchingTag
展開中にドライバーのプロパティと一致するカスタム タグを指定します。 タグを指定すると、展開プロセスは、一致するドライバーをダウンロードしてターゲット イメージにインストールするために、ホスト プロファイルで指定されたタグとドライバーのタグを照合します。
| 型: | System.Collections.Generic.List`1[System.String] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FullName
仮想マシンが登録されているユーザーの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-GuiRunOnceCommands
無人応答ファイルの [GuiRunOnce] セクションに追加するコマンドの配列を指定します。 二重引用符で囲まれた各文字列を囲む単一引用符を使用します。
形式の例: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Windows PowerShell で引用符を使用する方法については、「Get-Help about_Quoting_Rules」と入力します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsGuarded
ホストが保護されたホストである必要があることを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JoinWorkgroup
この操作がワークグループに参加することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LocalAdministratorCredential
ローカル管理者アカウント (Linux と互換性のあるゲスト オペレーティング システム プロファイルの場合は Linux ルート アカウント) のユーザー名とパスワードを指定します。
新規または既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシンで資格情報を指定すると、既存の管理者パスワードがオーバーライドされます。
| 型: | VMMCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OrganizationName
仮想マシンが登録されているユーザーの組織の名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller" - 形式の例:
-Owner "PattiFuller@Contoso"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProductKey
プロダクト キーを指定します。 プロダクト キーは、製品ライセンスを識別する 25 桁の番号です。 プロダクト キーを使用して、VMM または仮想マシンまたはホストにインストールするオペレーティング システムを登録できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TimeZone
同じ標準時を共有する地理的リージョンを識別する数値 (インデックス) を指定します。
タイム ゾーン インデックスの一覧については、「
GMT 標準タイム ゾーンを指定する形式の例: -TimeZone 085
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VirtualHardDisk
仮想ハード ディスク オブジェクトを指定します。
| 型: | VirtualHardDisk |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostNetworkAdapterProfile
ホスト ネットワーク アダプター プロファイル オブジェクトを指定します。
| 型: | PhysicalComputerNetworkAdapterProfile[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostProfile
仮想マシン ホスト プロファイル オブジェクトを指定します。
| 型: | PhysicalComputerProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMPaths
仮想マシン ファイルを格納できるホスト上の既定のパスのセット (パイプライン 演算子で区切られた文字列として) を指定します。
形式の例: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
HostProfile
このコマンドレットは、HostProfile オブジェクトを返します。