Remove-SCVirtualScsiAdapter
从 VMM 中删除虚拟 SCSI 适配器对象。
语法
Remove-SCVirtualScsiAdapter
[-VirtualScsiAdapter] <VirtualSCSIAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
说明
Remove-SCVirtualScsiAdapter cmdlet 从 Virtual Machine Manager (VMM) 环境中使用的虚拟机、虚拟机模板或硬件配置文件中删除一个或多个虚拟 SCSI 适配器对象。
Remove-SCVirtualSCSIAdapter cmdlet 仅当适配器未附加任何设备时才成功删除虚拟 SCSI 适配器。
Citrix XenServer 主机上的虚拟机始终具有一个虚拟 SCSI 适配器。 无法删除此适配器。
此 cmdlet 在成功 (时返回对象,属性 MarkedForDeletion 设置为 True) 或在失败时返回错误消息。
示例
示例 1:从虚拟机中删除第三个虚拟 SCSI 适配器
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapter
第一个命令获取名为 VM01 的虚拟机对象,并将对象存储在$VM变量中。
第二个命令获取 VM01 上的所有虚拟 SCSI 适配器对象,并将对象存储在$Adapter对象数组中。 一个虚拟机可最多连接四个虚拟 SCSI 适配器。 此示例假定 VM01 至少有三个虚拟 SCSI 适配器。
最后一个命令将第三个虚拟 SCSI 适配器 ($Adapter[2]) 传递给 Remove-SCVirtualScsiAdapter,从 VM01 中删除此虚拟 SCSI 适配器。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
在运行最后一个包含相同作业组标识符的命令之前,为作为集合运行的一系列命令指定标识符。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行,以便控件立即返回到命令 shell。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualScsiAdapter
指定虚拟机的虚拟 SCSI 适配器对象。
虚拟 SCSI 适配器的主机编号的类型
Hyper-V:每个 VM 最多四个合成虚拟 SCSI 适配器,每个适配器最多 64 个设备。 支持的虚拟磁盘驱动器最大为 2040 GB。 不支持仿真虚拟 SCSI 适配器。 VMware ESX:每个 VM 最多四个虚拟 SCSI 适配器,每个适配器最多 15 个设备。 支持的虚拟磁盘驱动器最大为 2048 GB。 Citrix XenServer:每个 VM 始终有一个虚拟 SCSI 适配器,每个适配器最多有 8 台设备。 支持的虚拟磁盘驱动器最大为 2048 GB。
Type: | VirtualSCSIAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
备注
- 需要 VMM 虚拟 SCSI 适配器对象,可以使用 Get-SCVirtualScsiAdapter cmdlet 检索该对象。