次の方法で共有


Get-SCVirtualScsiAdapter

仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルから VMM 仮想 SCSI アダプター オブジェクトを取得します。

構文

Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCVirtualScsiAdapter コマンドレットは、仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトから、仮想マシン マネージャー (VMM) 環境で使用される 1 つ以上の仮想 SCSI アダプター オブジェクトを取得します。

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

例 1: 仮想マシン上のすべての仮想 SCSI アダプターを取得する

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

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

2 番目のコマンドは、VM01 上のすべての仮想 SCSI アダプター オブジェクトを取得し、アダプターに関する情報をユーザーに表示します。

例 2: 仮想マシン テンプレート内のすべての仮想 SCSI アダプターを取得する

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

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

2 番目のコマンドは、VMTemplate01 上のすべての仮想 SCSI アダプター オブジェクトを取得し、アダプターに関する情報をユーザーに表示します。

例 3: ハードウェア プロファイルからすべての仮想 SCSI アダプターを取得する

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

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

2 番目のコマンドは、NewHWProfile01 上のすべての SCSI アダプター オブジェクトを取得し、アダプターに関する情報をユーザーに表示します。

パラメーター

-All

このコマンドレットは、親オブジェクトに依存しないすべての下位オブジェクトを取得することを示します。 たとえば、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します Get-SCVirtualDiskDrive -All

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

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-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-SCVirtualMachineGet-SCVMTemplate、または Get-SCHardwareProfile コマンドレットを使用して取得できる VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。