Set-SCVMHostProfile
ホスト プロファイルのプロパティを変更します。
構文
Set-SCVMHostProfile
-VMHostProfile <PhysicalComputerProfile>
[-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
[[-Name] <String>]
[-VirtualHardDisk <VirtualHardDisk>]
[-Domain <String>]
[-DomainJoinRunAsAccount <RunAsAccount>]
[-LocalAdministratorCredential <VMMCredential>]
[-RemoveAnswerFile]
[-RemoveGuiRunOnceCommands]
[-Description <String>]
[-Owner <String>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-GuiRunOnceCommands <String[]>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-AnswerFile <Script>]
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Set-SCVMHostProfile コマンドレットは、ホスト プロファイルのプロパティを変更します。
ホスト プロファイルを作成する方法については、「.」と入力します Get-Help New-SCVMHostProfile -Detailed
。
例
例 1: 指定したホスト プロファイルのタイム ゾーン値を設定する
PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035
このコマンドは、HostProfile01 という名前のホスト プロファイル オブジェクトを取得し、そのタイム ゾーン値を米国東部タイム ゾーン (035) に設定します。
例 2: ホスト・ネットワーク・アダプター・プロファイルをホスト・プロファイルに追加する
PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf
最初のコマンドは、HostProfile01 という名前のホスト プロファイル オブジェクトを取得し、$VMHostProfile変数にオブジェクトを格納します。
2 番目のコマンドは、ID が 259f47c7-c5a9-429d-a421-d232f9b34991 のホスト ネットワーク アダプター プロファイル オブジェクトを取得し、$HostNetAdapterProf変数にオブジェクトを格納します。
最後のコマンドは、$HostNetAdapterProfに格納されているホスト ネットワーク アダプター プロファイルを HostProfile01 に追加します。
パラメーター
-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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainJoinRunAsAccount
指定したドメインに参加するアクセス許可を持つ実行アカウントを指定します。
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | False |
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
同じジョブ グループ ID を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの ID を指定します。
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 |
-LocalAdministratorCredential
ローカル管理者アカウント (Linux 互換のゲスト オペレーティング システム プロファイルの場合は Linux ルート アカウント) のユーザー名とパスワードを指定します。
新規または既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシンで資格情報を指定すると、既存の管理者パスワードがオーバーライドされます。
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
VMM オブジェクトの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
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 |
-RemoveAnswerFile
この操作によって、ホスト プロファイルから応答ファイルが削除されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveGuiRunOnceCommands
この操作により、GUI Run Once Commands プロパティがホスト プロファイルから削除されます。
Type: | SwitchParameter |
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: | False |
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[]
このコマンドレットは、1 つ以上の HostProfile オブジェクトを 返します。