Share via


Get-SCVirtualScsiAdapter

從虛擬機器、虛擬機器範本或硬體設定檔取得 VMM 虛擬 SCSI 配接器物件。

Syntax

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 都會取得所有虛擬磁片磁碟機物件。

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

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

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

-OnBehalfOfUserRole

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

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

此 Cmdlet 會傳回 VirtualSCSIAdapter 物件。

備註

  • 需要 VMM 虛擬機器物件、虛擬機器範本物件或硬體設定檔物件,這可以使用 Get-SCVirtualMachineGet-SCVMTemplateGet-SCHardwareProfile Cmdlet 分別擷取。