Remove-SCVMHost
從 VMM 移除虛擬機器主機。
Syntax
Remove-SCVMHost
[-VMHost] <Host>
[-VMMServer <ServerConnection>]
[-Credential <VMMCredential>]
[-RemoveHostWithVMs]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-SCVMHost
[-VMHost] <Host>
[-VMMServer <ServerConnection>]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Remove-SCVMHost Cmdlet 會從 Virtual Machine Manager (VMM) 移除一或多個虛擬機器主機。 Remove-SCVMHost Cmdlet 的運作方式如下：
- 僅限主機伺服器。 如果這部電腦是 Hyper-V 主機，但不是程式庫伺服器，則會從 VMM 資料庫移除主機物件，並從實體主機伺服器卸載 VMM 代理程式軟體。
如果主機是 VMware ESX 主機或 Citrix XenServer 主機，則會從 VMM 資料庫移除主機物件。 VMM 不會在 ESX 主機或 XenServer 主機上安裝代理程式。
- 主機和程式庫伺服器。 如果這部電腦是 Hyper-V 主機，而且也是程式庫伺服器，此命令只會移除主機功能，但會保留程式庫伺服器功能。 也就是說，主機物件會從 VMM 資料庫移除，但 VMM 代理程式軟體不會從實體伺服器卸載。 程式庫伺服器物件會保留在資料庫中。
如果主機是 ESX 主機，它只能當做 VMM 中的虛擬機器主機運作。 它不能同時做為主機和程式庫伺服器。
- 認證。 如果 Hyper-V 主機已加入 Active Directory 網域，您必須提供具有適當許可權的帳號憑證，才能從 VMM 移除該主機電腦。
您不需要提供 Active Directory 認證，即可從 VMM 移除周邊網路主機、ESX 主機或 XenServer 主機。
- 虛擬機器： 當您移除主機時，主機不再由 VMM 管理。 不過，不會移除或解除與伺服器關聯主機伺服器上的任何虛擬機器。 也不會關閉任何執行中的虛擬機器。 雖然虛擬機器不再受 VMM 管理，但不會以任何其他方式受到影響。
- 強制移除。 當您沒有適當的認證來管理該主機或 VMM 伺服器無法再與該主機通訊時，您可以使用 Force 參數搭配 Remove-SCVMHost Cmdlet，從 VMM 移除虛擬機器主機。
當您指定 Force 參數時，VMM 不會要求或檢查認證，也不會讓 VMM 嘗試連線到主機並卸載 VMM 代理程式。 因此，只有在從 VMM 資料庫移除過時的主機記錄時，才建議使用 Force 參數。
此 Cmdlet 會在成功 (時傳回 物件，並將 MarkedForDeletion 屬性設定為 $True) ，或在失敗時傳回錯誤訊息。
範例
範例 1：從 VMM 移除已加入網域的特定主機
PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm第一個命令會使用 Get-Credential Cmdlet 提示您提供使用者名稱和密碼，並將提供的認證儲存在 $Credential 變數中。 此作業的必要認證是具有系統管理員許可權的網域帳戶，可從 VMM 移除加入 Active Directory 網域的 Windows 主機伺服器。
第二個命令會取得名為 VMHost01 的主機物件，並將物件儲存在$VMHost變數中。
第三個命令會移除儲存在 $VMHost 中的主機物件。 處理此命令時，$Credential提供 Remove-VMHost的認證，而 Confirm 參數會提示您確認是否要從 VMM 移除此主機。
範例 2：從 VMM 移除不是主機叢集中節點的所有主機
PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm第一個命令會取得所有主機物件、排除主機叢集中節點的任何主機、只選取代表 VMware ESX 主機、周邊網路主機或非信任網域主機的物件，然後確認您想要移除這些物件時，請從 VMM 移除這些物件。 不需要認證，就可以移除這些主機。
第二個命令會提示您為有權從 VMM 移除已加入網域的 Windows 主機的帳戶提供使用者名稱和密碼，並將您的認證儲存在$Credential中。
最後一個命令會取得不屬於主機叢集一部分的所有已加入網域的 Windows 主機物件，並將物件傳遞至 Remove-VMHost Cmdlet。 處理此命令時，$Credential提供您的認證給 Remove-VMHost，而 Confirm 參數會提示您確認您想要從 VMM 移除這些主機。
範例 3：移除您無法再從 VMM 存取的特定主機
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm第一個命令會取得名為 VMHost03 的主機物件，並將物件儲存在$VMHost變數中。
Force參數上的第二個命令會切換，以確保從 VMM 資料庫移除 VMHost03。 此操作不需要認證。 Confirm參數會提示您確認是否要移除此主機。
注意：當您沒有該主機的認證或 VMM 伺服器無法再與該主機通訊時，您可以使用 Force 參數從 VMM 移除主機。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定認證物件，或針對某些 Cmdlet 指定執行身分帳戶物件，其中包含有權執行此動作之帳戶的使用者名稱和密碼。 或者，如果是 Restart-SCJob，則有權完成重新開機的工作。
如需 PSCredential 物件的詳細資訊，請輸入 Get-Help Get-Credential 。
如需執行身分帳戶的詳細資訊，請輸入 Get-Help New-SCRunAsAccount 。
| Type: | VMMCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
強制執行命令而不要求使用者確認。
| Type: | SwitchParameter |
| 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 |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveHostWithVMs
如需 PSCredential 物件的詳細資訊，請輸入 Get-Help Get-Credential 。
如需執行身分帳戶的詳細資訊，請輸入 Get-Help New-SCRunAsAccount 。
| Type: | SwitchParameter |
| 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 |
-VMHost
指定虛擬機器主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。
如需每種主機類型的詳細資訊，請參閱 Add-SCVMHost Cmdlet。
| Type: | Host |
| Position: | 0 |
| 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 |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |