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
| 型: | DeploymentOption |
| 指定可能な値: | None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationLocation
仮想ハード ディスクまたは仮想ハード ディスク上の宛先パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileInjectionDestinationLocation
仮想マシンを初めて有効にする前に、ソース ファイルを選択した VHD に挿入するターゲット フォルダー パス (パーティションのルートへの相対パス) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileInjectionDestinationPartition
仮想マシンを初めて有効にする前にソース ファイルが挿入される、選択した VHD のターゲット パーティションを指定します。
| 型: | Int16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileInjectionSourceLocation
仮想マシンを初めて有効にする前に、仮想マシンに挿入するファイルの場所 (URL) を指定します。
フォルダーを指定すると、そのフォルダーの下にあるすべてのファイルが、指定した移動先の場所に挿入されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileName
仮想ハード ディスク ファイルを仮想マシンに追加するときに名前を変更するときに使用するファイル名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParentVirtualHardDiskDestinationPath
親仮想ハード ディスクの宛先パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParentVirtualHardDiskPath
差分ディスクの作成時に使用する親仮想ハード ディスクへのパスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PinDestinationLocation
ユーザーが選択した宛先の場所がサービス展開の構成中に保持されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PinFileName
ユーザーが選択したファイル名がサービス展開の構成中に保持されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PinSourceLocation
ユーザーが選択したソースの場所がサービスの展開構成中に保持されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PinStorageDisk
ユーザーが選択したストレージ ディスクがサービス展開の構成中に保持されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SourceDisk
ソース仮想ハード ディスクを指定します。
| 型: | StandaloneVirtualHardDisk |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StorageClassification
ストレージ分類オブジェクトを指定します。
| 型: | StorageClassification |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StorageDisk
仮想ハード ディスクを使用する代わりに、そのホスト上の仮想マシンが使用できる Hyper-V または VMware ESX ホスト上のディスクを指定します。 このディスクはパススルー ディスクと呼ばれます。 対応する VMware 用語は、生デバイス マッピング (RDM) です。 ホスト ディスクは、ローカル ハード ディスクまたは記憶域ネットワーク (SAN) 上の論理ユニットです。 VMM を使用すると、仮想マシンはホストのファイル システムをバイパスし、パススルー ディスクに直接アクセスできます。 Hyper-V ホストでは、パススルー ディスクと、パススルー ディスクから VHD への変換がサポートされます。 VMware ESX ホストはパススルー ディスクをサポートしますが、ディスク変換はサポートしていません。 Citrix XenServer ホストはパススルー ディスクをサポートしていません。
| 型: | StorageDisk |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StorageQoSPolicy
StorageQoSPolicy オブジェクトを指定します。
| 型: | StorageQoSPolicy |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VHDConfiguration
仮想ハード ディスク構成オブジェクトを指定します。
| 型: | VirtualHardDiskConfiguration |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VirtualHardDiskConfiguration
このコマンドレットは、VirtualHardDiskConfiguration オブジェクト