New-SCPhysicalComputerProfile

モジュール:

VirtualMachineManager

オペレーティング システムをコンピューターに展開するために使用するプロファイルを作成します。

構文

New-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsVMHost]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-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-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   [-JoinWorkgroup]
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsVMHost]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-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-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsFileServer]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-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-SCPhysicalComputerProfile
   [-Name] <String>
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCPhysicalComputerProfile コマンドレットは、オペレーティング システムをコンピューターに展開するために使用されるプロファイルを作成します。

例

例 1: 物理コンピューター プロファイルを作成する

PS C:\> $Account = Get-SCRunaAsAccount -Name "CloudAdmin" 
PS C:\> $Credential = Get-Credential "Contoso\ServiceAdmin" 
PS C:\> $AdapterProfile = Get-SCPhysicalComputerNetworkAdapterProfile -ID "eede207d-d263-4212-ad32-fd29b5a1a6ce" 
PS C:\> $Vhd = Get-SCVirtualHardDisk -Name "Win2012stdGen1template_disk_1.vhdx" 
PS C:\> New-SCPhysicalComputerProfile -Name "ContosoHostProfile" -Domain "contoso.com" -DomainJoinRunAsAccount $Account -LocalAdministratorCredential $Credential -PhysicalComputerNetworkAdapterProfile $AdapterProfile -UseAsVMHost -VirtualHardDisk $Vhd

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

2 番目のコマンドは、Contoso\ServiceAdmin アカウントの Windows PowerShell 資格情報オブジェクトを作成し、$Credential変数に格納します。 Get-Credential コマンドレットに ServiceAdmin アカウントのパスワードを指定する必要があります。

3 番目のコマンドは、指定した ID を持つ物理コンピューター ネットワーク アダプター プロファイルへのオブジェクト参照を作成し、$AdapterProfile変数に格納します。

4 番目のコマンドは、get-SCVirtualHardDisk コマンドレット 使用してオブジェクト参照を作成します。 このオブジェクト参照は、仮想ハード ディスク Win2012stdGen1template_disk_1.vhdx に関連付けられています。

最後のコマンドは、前のコマンドの値に基づいて ContosoHostProfile という名前の物理コンピューター プロファイルを作成します。

パラメーター

-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 オブジェクトの配列を指定します。

型:	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 で展開する物理コンピューターのディスクとパーティションの構成を指定します。

形式の例: -DiskConfiguration "MBR=1:PRIMARY:QUICK:4:FALSE:OS::0:BOOTPARTITION;"

必ず正しいクラスター サイズを指定する必要があります。 上の例では、クラスター サイズは 0 です。 クラスター サイズを指定しない場合、VMM では既定値の 512 バイトが使用されます。これは、高度なフォーマット ディスクを構成するのに適していない可能性があります。

型:	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

-PhysicalComputerNetworkAdapterProfile

物理コンピューター ネットワーク アダプター プロファイル オブジェクトの配列を指定します。

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

-PhysicalComputerProfile

オペレーティング システムをコンピューターに展開するために使用するプロファイルを指定します。

型:	PhysicalComputerProfile
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	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

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

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

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

-UseAsFileServer

プロファイルをファイル サーバー プロファイルとしてマークします。

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

-UseAsVMHost

プロファイルを仮想マシン ホスト プロファイルとしてマークします。

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

-VirtualHardDisk

仮想ハード ディスク オブジェクトを指定します。

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

-VMMServer

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

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

-VMPaths

仮想マシン ファイルを格納できるホスト上の既定のパスのセット (パイプライン 演算子で区切られた文字列として) を指定します。

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

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

出力

PhysicalComputerProfile

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

関連リンク

• Get-SCPhysicalComputerProfile
• Get-SCVirtualHardDisk
• Remove-SCPhysicalComputerProfile
• Set-SCPhysicalComputerProfile