Remove-SCVMHost

Modulo:

VirtualMachineManager

Rimuove un host di macchine virtuali da VMM.

Sintassi

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>]

Descrizione

Il cmdlet Remove-SCVMHost rimuove uno o più host di macchine virtuali da Virtual Machine Manager (VMM). Il cmdlet Remove-SCVMHost opera come segue:

• Solo server host. Se questo computer è un host Hyper-V ma non è anche un server di libreria, l'oggetto host viene rimosso dal database VMM e il software agente VMM viene disinstallato dal server host fisico.

Se l'host è un host VMware ESX o un host Citrix XenServer, l'oggetto host viene rimosso dal database VMM. VMM non installa un agente negli host ESX o negli host XenServer.

• Server host e libreria. Se questo computer è un host Hyper-V ed è anche un server di libreria, questo comando rimuove solo la funzionalità host, ma lascia al posto la funzionalità del server di libreria. Ovvero, l'oggetto host viene rimosso dal database VMM, ma il software dell'agente VMM non viene disinstallato dal server fisico. L'oggetto server di libreria rimane nel database.

Se l'host è un host ESX, può funzionare solo come host di macchine virtuali in VMM. ma non come server host e di libreria.

• Credenziali. Se un host Hyper-V viene aggiunto a un dominio di Active Directory, è necessario specificare le credenziali per un account con autorizzazioni appropriate per rimuovere tale computer host da VMM.

Non è necessario fornire credenziali di Active Directory per rimuovere un host di rete perimetrale, un host ESX o un host XenServer da VMM.

• Macchine virtuali. Quando si rimuove un host, l'host non è più gestito da VMM. Tuttavia, tutte le macchine virtuali nel server host non verranno rimosse o annullate dal server. Le macchine virtuali in esecuzione non verranno arrestate. Anche se le macchine virtuali non sono più gestite da VMM, non sono interessate in alcun altro modo.
• Rimozione forzata. È possibile usare il parametro Force con il cmdlet Remove-SCVMHost per rimuovere un host di macchine virtuali da VMM quando non sono disponibili credenziali appropriate per gestire tale host o quando il server VMM non può più comunicare con tale host.

Quando si specifica il parametro Force , VMM non chiede o controlla le credenziali, né vMM tenta di connettersi all'host e disinstallare l'agente VMM. L'uso del parametro Force è quindi consigliato solo quando si rimuoveno record host non aggiornati dal database VMM.

Questo cmdlet restituisce l'oggetto al termine dell'operazione (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore al momento dell'errore.

Esempio

Esempio 1: Rimuovere un host aggiunto a un dominio specifico da VMM

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

Il primo comando usa il cmdlet Get-Credential per richiedere di specificare un nome utente e una password e archivia le credenziali fornite nella variabile $Credential. Le credenziali necessarie per questa operazione sono un account di dominio con diritti di amministratore per rimuovere un server host basato su Windows aggiunto a un dominio di Active Directory da VMM.

Il secondo comando ottiene l'oggetto host denominato VMHost01 e archivia l'oggetto nella variabile $VMHost.

Il terzo comando rimuove l'oggetto host archiviato in $VMHost. Poiché questo comando viene elaborato, $Credential fornisce le credenziali per Remove-VMHost e il parametro Conferma richiede di confermare che si vuole rimuovere l'host da VMM.

Esempio 2: Rimuovere tutti gli host che non sono nodi in un cluster host da 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

Il primo comando ottiene tutti gli oggetti host, esclude tutti gli host che sono nodi in un cluster host, seleziona solo gli oggetti che rappresentano host VMware ESX, host di rete perimetrali o host di dominio non attendibili e quindi rimuove tali oggetti da VMM se si conferma che si desidera rimuoverli. Per rimuovere tali host non è necessario immettere credenziali.

Il secondo comando richiede di specificare un nome utente e una password per un account con autorizzazioni per rimuovere gli host Windows aggiunti al dominio da VMM e archiviare le credenziali in $Credential.

L'ultimo comando ottiene tutti gli oggetti host basati su Windows aggiunti al dominio che non fanno parte di un cluster host e passano gli oggetti al cmdlet Remove-VMHost . Poiché questo comando viene elaborato, $Credential fornisce le credenziali per Remove-VMHost e il parametro Conferma richiede di confermare che si desidera rimuovere questi host da VMM.

Esempio 3: Rimuovere un host specifico che non è più possibile accedere da VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

Il primo comando ottiene l'oggetto host denominato VMHost03 e archivia l'oggetto nella variabile $VMHost.

Il secondo comando passa al parametro Force per assicurarsi che VMHost03 venga rimosso dal database VMM. Per questa operazione non sono necessarie credenziali. Il parametro Confirm richiede di confermare che si vuole rimuovere l'host.

Nota: è possibile usare il parametro Force per rimuovere un host da VMM quando non si dispone delle credenziali per tale host o quando il server VMM non può più comunicare con tale host.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Specifica un oggetto credenziale o, per alcuni cmdlet, un oggetto account RunAs contenente il nome utente e la password di un account che dispone dell'autorizzazione per eseguire questa azione. In alternativa, nel caso di Restart-SCJob, è disponibile l'autorizzazione per completare un'attività riavviata.

Per altre informazioni sull'oggetto PSCredential , digitare Get-Help Get-Credential.

Per altre informazioni sugli account RunAs, digitare Get-Help New-SCRunAsAccount.

Type:	VMMCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveHostWithVMs

Per altre informazioni sull'oggetto PSCredential , digitare Get-Help Get-Credential.

Per altre informazioni sugli account RunAs, digitare Get-Help New-SCRunAsAccount.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMHost

Specifica un oggetto host di macchina virtuale. VMM supporta host Hyper-V, host VMware ESX e host Citrix XenServer.

Per altre informazioni su ogni tipo di host, vedere il cmdlet Add-SCVMHost .

Type:	Host
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Collegamenti correlati

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Get-SCVMHost
• Move-SCVMHost
• New-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost