New-SCVirtualScsiAdapter

モジュール:

VirtualMachineManager

VMM で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに仮想 SCSI アダプターを作成します。

構文

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -JobGroup <Guid>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

New-SCVirtualScsiAdapter コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに仮想 SCSI アダプターを作成します。 仮想 SCSI アダプターを作成したら、 Set-SCVirtualScsiAdapter コマンドレットを使用してその設定を変更できます。

注: ゲスト クラスタリングを有効にするために ShareVirtualScsiAdapter パラメーターを使用して仮想マシン上の仮想 SCSI アダプターを共有することは、仮想マシンが ESX ホストにデプロイされている場合にのみサポートされます。 Hyper-V ホスト上の仮想マシンでは共有ストレージに iSCSI が使用されるため、 SharedVirtualScsiAdapter パラメーターは Hyper-V ホスト上の仮想マシンには使用されません。

Citrix XenServer ホスト上の仮想マシンには、常に 1 つの仮想 SCSI アダプターがあります。 このアダプターを取り外したり、アダプターを追加したりすることはできません。

例

例 1: 仮想マシンに仮想 SCSI アダプターを作成する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM

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

2 番目のコマンドは、VM01 に仮想 SCSI アダプターを作成します。

例 2: 仮想マシン テンプレートに仮想 SCSI アダプターを作成する

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualScsiAdapter -VMTemplate $VMTemplate

最初のコマンドは、VMM ライブラリから VMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $VMTemplate 変数に格納します。

2 番目のコマンドは、VMTemplate01 に仮想 SCSI アダプターを作成します。

例 3: ハードウェア プロファイルに仮想 SCSI アダプターを作成する

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualScsiAdapter -HardwareProfile $HWProfile

最初のコマンドは、VMM ライブラリから NewHWProfile01 という名前のハードウェア プロファイル オブジェクトを取得し、$HWProfile変数にオブジェクトを格納します。

2 番目のコマンドは、NewHWProfile01 に仮想 SCSI アダプターを作成します。

パラメーター

-AdapterID

論理ユニット番号 (LUN ID) を指定します。 Hyper-V と XenServer では、この値は公開されず、変更できません。 VMware ESX ホストの場合、既定値は 7 で、変更できません。

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

-HardwareProfile

ハードウェア プロファイル オブジェクトを指定します。

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

-JobGroup

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

Type:	Guid
Position:	Named
Default value:	None
Required:	True
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

-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

-ScsiControllerType

SCSI コントローラーの種類を指定します。 有効な値は次のとおりです。

• DefaultType
• NoType
• LsiLogic
• BusLogic
• ParaVirtualSCSI
• LsiLogicSAS

Type:	VMSCSIControllerType
Accepted values:	DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShareVirtualScsiAdapter

仮想 SCSI アダプターをゲスト クラスタリングで使用できるように共有するかどうかを示します。

• Hyper-V ホスト: いいえ (ゲスト クラスタリングの場合は、iSCSI ストレージを使用します)
• XenServer ホスト: いいえ (Xen VM には常に SCSI アダプターが 1 つだけ存在します)

注: ESX ホスト上の仮想マシン上で SCSI コントローラーを共有する場合、VMM は VMware 上の SCSI 共有ポリシーを既定で "物理" に設定します。

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

-Synthetic

Hyper-V ホストにデプロイされた仮想マシン上の仮想ネットワーク アダプターなどのデバイスが、高パフォーマンスの合成デバイスであることを示します。 バーチャル マシンには仮想化対応のゲスト オペレーティング システムが必要です。

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

-VM

仮想マシン オブジェクトを指定します。

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

-VMTemplate

仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。

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

出力

VirtualSCSIAdapter

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

メモ

• それぞれ Get-SCVirtualMachine、Get-SCVMTemplate、または Get-SCHardwareProfile コマンドレットを使用して取得できる VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。

関連リンク

• Get-SCHardwareProfile
• Get-SCVirtualMachine
• Get-SCVirtualScsiAdapter
• Get-SCVMMServer
• Get-SCVMTemplate
• Remove-SCVirtualScsiAdapter
• Set-SCVirtualScsiAdapter