Remove-SCVirtualScsiAdapter
從 VMM 移除虛擬 SCSI 配接器物件。
語法
Remove-SCVirtualScsiAdapter
[-VirtualScsiAdapter] <VirtualSCSIAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
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 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-JobGroup
指定一系列命令的標識碼,這些命令將在包含相同作業群組標識符的執行的最後一個命令之前,以集合的形式執行。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | 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 |
-VirtualScsiAdapter
指定虛擬機的虛擬 SCSI 配接器物件。
虛擬 SCSI 適配卡的主機號碼類型
Hyper-V:每個 VM 最多四個綜合虛擬 SCSI 適配卡,以及每個適配卡最多 64 部裝置。 支援最多 2040 GB 的虛擬磁碟驅動器大小。 不支援仿真的虛擬 SCSI 適配卡。 VMware ESX:每個 VM 最多 4 個虛擬 SCSI 適配卡,以及每個適配卡最多 15 部裝置。 支援高達 2048 GB 的虛擬磁碟驅動器大小。 Citrix XenServer:每個 VM 一律有一個虛擬 SCSI 適配卡,每個適配卡最多 8 部裝置。 支援高達 2048 GB 的虛擬磁碟驅動器大小。
類型: | VirtualSCSIAdapter |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
備註
- 需要 VMM 虛擬 SCSI 適配卡物件,可以使用 Get-SCVirtualScsiAdapter Cmdlet 來擷取。