次の方法で共有


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 オブジェクトを返します。