New-SCVirtualScsiAdapter
在 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>] 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 且無法變更。
| 類型: | Byte |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-HardwareProfile
指定硬體配置檔物件。
| 類型: | HardwareProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-JobGroup
指定一系列命令的標識碼，這些命令將在包含相同作業群組標識符的執行的最後一個命令之前，以集合的形式執行。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUser
指定用戶的名稱。 這個 Cmdlet 會將代表用戶設定為此參數所指定的使用者。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUserRole
指定使用者角色。 此 Cmdlet 會將代表使用者角色設定為此參數所指定的使用者角色。 若要取得使用者角色物件，請使用 Get-SCUserRole Cmdlet。
| 類型: | UserRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ScsiControllerType
指定 SCSI 控制器類型。 有效值為：
- DefaultTypeNoType
- LsiLogic
- BusLogic
- ParaVirtualSCSI
- LsiLogicSAS
| 類型: | VMSCSIControllerType |
| 接受的值: | DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ShareVirtualScsiAdapter
指出虛擬 SCSI 適配卡是否共用，以便可用於客體叢集。
- Hyper-V 主機：否（針對客體叢集，請使用 iSCSI 記憶體）
- XenServer 主機：否（Xen VM 一律只有一個 SCSI 適配卡）
注意：在 ESX 主機上的虛擬機上共用 SCSI 控制器時，VMM 會將 VMware 上的 SCSI 共用原則預設為「實體」。
| 類型: | Boolean |
| 別名: | Shared |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Synthetic
指出部署在 Hyper-V 主機上的虛擬機上，例如虛擬網路適配器是高效能綜合裝置。 虛擬機上需要虛擬化感知客體操作系統。
| 類型: | SwitchParameter |
| 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-SCVirtualMachine、Get-SCVMTemplate或 Get-SCHardwareProfile Cmdlet 來擷取。