Set-SCVirtualHardDiskConfiguration
仮想マシンの構成に含まれる仮想ハード ディスク構成情報を変更します。
構文
Set-SCVirtualHardDiskConfiguration
[-SourceDisk <StandaloneVirtualHardDisk>]
[-PinSourceLocation <Boolean>]
[-DestinationLocation <String>]
[-PinDestinationLocation <Boolean>]
[-FileName <String>]
[-PinFileName <Boolean>]
[-DeploymentOption <DeploymentOption>]
[-StorageDisk <StorageDisk>]
[-StorageClassification <StorageClassification>]
[-StorageQoSPolicy <StorageQoSPolicy>]
[-PinStorageDisk <Boolean>]
[-ParentVirtualHardDiskPath <String>]
[-ParentVirtualHardDiskDestinationPath <String>]
[-FileInjectionSourceLocation <String>]
[-FileInjectionDestinationLocation <String>]
[-FileInjectionDestinationPartition <Int16>]
-VHDConfiguration <VirtualHardDiskConfiguration>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 説明
Set-SCVirtualHardDiskConfiguration コマンドレットは、仮想マシン構成に含まれる仮想ハード ディスク構成情報を変更します。
例
例 1: 仮想ハード ディスク構成のプロパティを設定する
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VHDConfig = Get-SCVirtualHardDiskConfiguration -VMConfiguration $VMConfig[0]
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Win2k8R2BaseDisk.vhd"
PS C:\> Set-SCVirtualHardDiskConfiguration -VHDConfiguration $VHDConfig -SourceDisk $VHD -PinSourceLocation $True最初のコマンドは、Service01 という名前のサービス構成オブジェクトを取得し、$ServiceConfig変数にオブジェクトを格納します。
2 番目のコマンドは、$ServiceConfigに格納されているサービス構成オブジェクトのコンピューター層の構成を取得し、$TierConfig変数にオブジェクトを格納します。
3 番目のコマンドは、$TierConfigに格納されているコンピューター層構成の仮想マシン構成を取得し、オブジェクトを $VMConfig 変数に格納します。
4 番目のコマンドは、$VMConfigに格納されている最初の仮想マシン構成の仮想ハード ディスク構成を取得し、オブジェクトを $VHDConfig 変数に格納します。
5 番目のコマンドは、ライブラリから Win2k8R2BaseDisk.vhd という名前の仮想ハード ディスク オブジェクトを取得し、$VHD変数にオブジェクトを格納します。
最後のコマンドは、$VHDに格納されているソース仮想ハード ディスクの$VHDConfigに格納されている仮想ハード ディスク構成の PinSourceLocation プロパティを更新して、ソース仮想ハード ディスクの値をピン留めし、配置中に変更されないようにします。
パラメーター
-DeploymentOption
仮想ハード ディスクの展開オプションを指定します。 このパラメーターの有効値は、次のとおりです。
- なし
- UseFastest
- UseTarget
- UseNetwork
- UseSAN
- UseDifferencing
- UseExistingVirtualDisk
| Type: | DeploymentOption |
| Accepted values: | None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationLocation
仮想ハード ディスクまたは仮想ハード ディスク上の宛先パスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileInjectionDestinationLocation
仮想マシンを初めて有効にする前に、選択した VHD にソース ファイルを挿入するターゲット フォルダー パス (パーティションのルートへの相対パス) を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileInjectionDestinationPartition
仮想マシンを初めて有効にする前にソース ファイルを挿入する、選択した VHD のターゲット パーティションを指定します。
| Type: | Int16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileInjectionSourceLocation
仮想マシンを初めて有効にする前に、仮想マシンに挿入するファイルの場所 (URL) を指定します。
フォルダーを指定すると、そのフォルダーの下にあるすべてのファイルが、指定したコピー先の場所に挿入されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileName
仮想マシンへの追加時に仮想ハード ディスク ファイルの名前を変更するために使用するファイル名を指定します。
| Type: | String |
| 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 |
-ParentVirtualHardDiskDestinationPath
親仮想ハード ディスクの宛先パスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentVirtualHardDiskPath
差分ディスクの作成時に使用する親仮想ハード ディスクへのパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinDestinationLocation
ユーザーが選択した宛先の場所がサービス展開の構成中に保持されるかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinFileName
ユーザーが選択したファイル名がサービス展開の構成中に保持されるかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinSourceLocation
ユーザーが選択したソースの場所が、サービスのデプロイ構成中に保持されるかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinStorageDisk
ユーザーが選択したストレージ ディスクがサービス展開の構成中に保持されるかどうかを示します。
| Type: | Boolean |
| 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 |
-SourceDisk
ソース仮想ハード ディスクを指定します。
| Type: | StandaloneVirtualHardDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageClassification
ストレージ分類オブジェクトを指定します。
| Type: | StorageClassification |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageDisk
Hyper-V ホストまたは VMware ESX ホストでそのホスト上のバーチャル マシンがバーチャル ハード ディスクの代わりに使用できるディスクを指定します。 このディスクはパススルー ディスクと呼ばれます。 対応する VMware 用語は Raw Device Mapping (RDM) です。 ホスト ディスクは、ローカル ハード ディスクまたは記憶域ネットワーク (SAN) 上の論理装置のいずれかです。 VMM では、仮想マシンはホストのファイル システムをバイパスして、パススルー ディスクに直接アクセスできます。 Hyper-V ホストでは、パススルー ディスクと、パススルー ディスクから VHD への変換がサポートされます。 VMware ESX ホストはパススルー ディスクをサポートしますが、ディスク変換はサポートしていません。 Citrix XenServer ホストでは、パススルー ディスクはサポートされていません。
| Type: | StorageDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageQoSPolicy
StorageQoSPolicy オブジェクトを指定します。
| Type: | StorageQoSPolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VHDConfiguration
仮想ハード ディスク構成オブジェクトを指定します。
| Type: | VirtualHardDiskConfiguration |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
出力
VirtualHardDiskConfiguration
このコマンドレットは、 VirtualHardDiskConfiguration オブジェクトを返します。