Remove-SCVMHost

Modulo:

VirtualMachineManager

Rimuove un host macchina virtuale 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 funziona come segue:

• Solo server host. Se il computer è un host Hyper-V ma non è anche un server di libreria, l'oggetto host viene rimosso dal database VMM e il software dell'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 il computer è un host Hyper-V ed è anche un server di libreria, questo comando rimuove solo la funzionalità host, ma lascia attiva 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. Non può essere sia un host che un server di libreria.

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

Non è necessario specificare le 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 disassociate dal server. Le macchine virtuali in esecuzione non vengono arrestate. Anche se le macchine virtuali non sono più gestite da VMM, non sono interessate in altro modo.
• Rimozione forzata. È possibile usare il parametro force con il cmdlet Remove-SCVMHost per rimuovere un host macchina virtuale da VMM quando non si dispone delle 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 richiede né controlla le credenziali né VMM tenta di connettersi all'host e disinstallare l'agente VMM. Pertanto, l'uso del parametro Force è consigliato solo quando si rimuovono record host non aggiornati dal database VMM.

Questo cmdlet restituisce l'oggetto in caso di esito positivo (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore in caso di errore.

Esempio

Esempio 1: Rimuovere un host specifico aggiunto a un dominio 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 specificate 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. Durante l'elaborazione di questo comando, $Credential fornisce le credenziali per Remove-VMHoste 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 perimetrale o host di dominio non attendibili e quindi rimuove tali oggetti da VMM se si conferma di volerli rimuovere. Le credenziali non sono necessarie per rimuovere questi host.

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

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

Esempio 3: Rimuovere un host specifico a cui 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 attiva il parametro Force per assicurarsi che VMHost03 venga rimosso dal database VMM. Le credenziali non sono necessarie per questa operazione. 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 è più in grado di comunicare con tale host.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

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

Per altre informazioni sull'oggetto PSCredential , digitare .

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

Tipo:	VMMCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Force

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PROTipID

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

Tipo:	Guid
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RemoveHostWithVMs

Per altre informazioni sull'oggetto PSCredential , digitare .

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RunAsynchronously

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-VMHost

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

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

Tipo:	Host
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-VMMServer

Specifica un oggetto server VMM.

Tipo:	ServerConnection
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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