New-SCVirtualScsiAdapter

模組:

VirtualMachineManager

在 VMM 中使用的虛擬機器、虛擬機器範本或硬體設定檔上建立虛擬 SCSI 介面卡。

Syntax

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

Description

New-SCVirtualScsiAdapter Cmdlet 會在 Virtual Machine Manager (VMM) 環境中使用的虛擬機器、虛擬機器範本或硬體設定檔上建立虛擬 SCSI 介面卡。 建立虛擬 SCSI 介面卡之後，您可以使用 Set-SCVirtualScsiAdapter Cmdlet 來修改其設定。

注意：只有當虛擬機器部署在 ESX 主機上時，才支援使用 ShareVirtualScsiAdapter 參數在虛擬機器上共用虛擬 SCSI 介面卡，才能啟用客體叢集。 SharedVirtualScsiAdapter參數不會用於 Hyper-V 主機上的虛擬機器，因為 Hyper-V 主機上的虛擬機器會使用 iSCSI 進行共用儲存體。

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

範例

範例 1：在虛擬機器上建立虛擬 SCSI 介面卡

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

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

第二個命令會在 VM01 上建立虛擬 SCSI 介面卡。

範例 2：在虛擬機器範本上建立虛擬 SCSI 介面卡

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

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

第二個命令會在 VMTemplate01 上建立虛擬 SCSI 介面卡。

範例 3：在硬體設定檔上建立虛擬 SCSI 介面卡

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

第一個命令會從 VMM 程式庫取得名為 NewHWProfile01 的硬體設定檔物件，並將物件儲存在 $HWProfile 變數中。

第二個命令會在 NewHWProfile01 上建立虛擬 SCSI 介面卡。

參數

-AdapterID

指定邏輯單元編號或 LUN 識別碼。 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

指定使用者的名稱。 此 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

-PROTipID

指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 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 介面卡)

注意：在 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

此 Cmdlet 會傳回 VirtualSCSIAdapter 物件。

備註

• 需要 VMM 虛擬機器物件、虛擬機器範本物件或硬體設定檔物件，其可分別使用 Get-SCVirtualMachine、 Get-SCVMTemplate或 Get-SCHardwareProfile Cmdlet 來擷取。

相關連結

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