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>]
说明
New-SCVirtualScsiAdapter cmdlet 在虚拟机、虚拟机模板或虚拟机管理器(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 ID。 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 提示)的 ID。 此参数允许你审核 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 进行检索。