Set-SCVirtualDiskDrive

仮想ディスク ドライブの設定を変更します。

構文

Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -IOPSMaximum <UInt64>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-DisableStorageQoS]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCVirtualDiskDrive コマンドレットは、仮想マシンまたは仮想マシン マネージャー (VMM) 環境の仮想マシン テンプレート上の仮想ディスク ドライブ オブジェクトの設定を変更します。 このコマンドレットを使用して 、バス の種類 (IDE または SCSI) を変更したり、バスと LUN の設定を変更して仮想ディスク ドライブをバス上の別の場所に接続したりできます。

例 1: 仮想ディスク ドライブの IDE バスと LUN の設定を変更する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Eq 1 -And $VirtDiskDrive[0].Bus -Eq 0 -And $VirtDiskDrive[0].Lun -Eq 1){Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[0] -Bus 0 -LUN 0}

最初のコマンドは、 Get-SCVirtualMachine コマンドレットを使用して仮想マシン オブジェクト VM01 を取得します。 このコマンドは、そのオブジェクトを$VM変数に格納します。

2 番目のコマンドは、VM01 上の仮想ディスク ドライブ オブジェクトを取得し、そのオブジェクトを$VirtDiskDriveに格納します。 @ 記号とかっこを使用すると、コマンドが単一のオブジェクトまたは$Null値を返した場合でも、結果が配列に格納されます。

最後のコマンドは、仮想マシンに仮想ディスク ドライブが 1 つだけあり、最初の IDE チャネルの 2 番目のスロットにある場合、VM01 上の仮想ディスク ドライブのバス値を 0 に設定し、LUN 値を 0 に設定します。

例 2: 仮想ディスク ドライブのバスの種類を SCSI から IDE に変更する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1] -IDE -Bus 0 -LUN 1

最初のコマンドは、VM02 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、$VMに格納されている仮想マシン用に構成されているすべての仮想ディスク ドライブ オブジェクトを取得し、それらの仮想ディスク ドライブ オブジェクトを $VirtDiskDrive オブジェクト配列に格納します。 この例は、仮想ディスク ドライブが SCSI バス上にあることを前提としています。

最後のコマンドは、バスの種類を IDE に設定します。 このコマンドは、$VirtDiskDrive[1]で指定された 2 つ目の仮想ディスク ドライブを、-Bus 0 と LUN 1 で指定されたプライマリ チャネル (1) とスロット 2 に接続します。

パラメーター

-Bus

仮想ディスク ドライブを接続する IDE バスまたは仮想ディスク ドライブを接続する SCSI バスを指定します。

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateDiffDisk

コマンドレットが差分ディスクを作成するかどうかを示します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableStorageQoS

このコマンドレットが記憶域のサービス品質 (QoS) 標準を無効にしたことを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IDE

IDE が、仮想マシンまたはテンプレートで構成された仮想ディスク ドライブ オブジェクトをアタッチするバスの種類であることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IOPSMaximum

最大 IOPS を指定します。

Type:UInt64
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。

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

-LUN

仮想ディスク ドライブ オブジェクトまたは SCSI バス上の仮想ディスク ドライブ オブジェクトの論理ユニット番号 (LUN) を指定します。

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーに代わって動作します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

Type:UserRole
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

-SCSI

仮想マシンまたはテンプレート上に構成される仮想ディスク ドライブ オブジェクトの接続先となるバスの種類として SCSI を指定します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SharedStorage

仮想ディスク ドライブが共有記憶域を使用するかどうかを示します。

Type:Boolean
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

-StorageQoSPolicy

記憶域 QoS ポリシーを指定します。

Type:StorageQoSPolicy
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualDiskDrive

仮想ディスク ドライブ オブジェクトを指定します。 仮想ハード ディスクまたはパススルー ディスクを仮想ディスク ドライブ オブジェクトに接続できます。

Type:VirtualDiskDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VolumeType

仮想ハード ディスクのボリュームの種類を指定します。 このパラメーターの有効値は、次のとおりです。

  • ブート
  • システム
  • BootAndSystem
  • なし
Type:VolumeType
Accepted values:None, Boot, System, BootAndSystem
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

VirtualDiskDrive

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

メモ

  • このコマンドレットには、 Get-SCVirtualDiskDrive コマンドレットを使用して取得できる VMM 仮想ディスク ドライブ オブジェクトが必要です。