共用方式為


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>]

Description

Get-SCVirtualScsiAdapter Cmdlet 會從虛擬機物件、虛擬機範本物件或硬體配置檔物件,取得 Virtual Machine Manager (VMM) 環境中所使用的一或多個虛擬 SCSI 配接器物件。

Citrix XenServer 主機上的虛擬機一律有一個虛擬 SCSI 適配卡。 您無法移除此配接器或新增其他配接器。

範例

範例 1:取得虛擬機上的所有虛擬 SCSI 適配卡

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

第一個命令會取得名為 VM01 的虛擬機物件,並將物件儲存在$VM變數中。

第二個命令會取得 VM01 上的所有虛擬 SCSI 適配卡物件,並向用戶顯示適配卡的相關信息。

範例 2:取得虛擬機範本中的所有虛擬 SCSI 適配卡

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

第一個命令會從 VMM 連結庫取得名為 VMTemplate01 的虛擬機範本物件,並將物件儲存在$VMTemplate變數中。

第二個命令會取得 VMTemplate01 上的所有虛擬 SCSI 適配卡物件,並向用戶顯示適配卡的相關信息。

範例 3:從硬體配置檔取得所有虛擬 SCSI 適配卡

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

第一個命令會從 VMM 連結庫取得名為 NewHWProfile01 的硬體配置檔物件,並將物件儲存在$HWProfile變數中。

第二個命令會取得 NewHWProfile01 上的所有 SCSI 適配卡物件,並向使用者顯示適配卡的相關信息。

參數

-All

指出這個 Cmdlet 會取得與父對象無關的所有次級物件。 例如,命令 Get-SCVirtualDiskDrive -All 會取得所有虛擬磁碟驅動器物件,而不論每個虛擬磁碟驅動器對象相關聯的虛擬機物件或範本對象為何。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-HardwareProfile

指定硬體配置檔物件。

類型:HardwareProfile
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ID

將數值識別子指定為特定物件的全域唯一標識碼或 GUID。

類型:Guid
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-OnBehalfOfUser

指定用戶的名稱。 這個 Cmdlet 會將代表用戶設定為此參數所指定的使用者。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUserRole

指定使用者角色。 此 Cmdlet 會將代表使用者角色設定為此參數所指定的使用者角色。 若要取得使用者角色物件,請使用 Get-SCUserRole Cmdlet。

類型:UserRole
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VM

指定虛擬機物件。

類型:VM
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMTemplate

指定用來建立虛擬機的 VMM 範本物件。

類型:Template
別名:Template
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸出

VirtualSCSIAdapter

此 Cmdlet 會傳回 VirtualSCSIAdapter 物件。

備註

  • 需要 VMM 虛擬機物件、虛擬機範本物件或硬體配置檔物件,可以使用 Get-SCVirtualMachineGet-SCVMTemplateGet-SCHardwareProfile Cmdlet 來擷取。