Remove-SCVMHost

Modul:

VirtualMachineManager

Odebere hostitele virtuálního počítače z nástroje 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

Rutina Remove-SCVMHost odebere jednoho nebo více hostitelů virtuálních počítačů z nástroje Virtual Machine Manager (VMM). Rutina Remove-SCVMHost funguje takto:

• Pouze hostitelský server. Pokud je tento počítač hostitelem Hyper-V, ale není také serverem knihovny, odebere se hostitelský objekt z databáze VMM a software agenta VMM se odinstaluje z fyzického hostitelského serveru.

Pokud je hostitelem hostitele VMware ESX nebo hostitelem Citrix XenServer, odebere se hostitelský objekt z databáze VMM. Nástroj VMM neinstaluje agenta na hostitele ESX ani na hostitele XenServer.

• Server hostitele a knihovny. Pokud je tento počítač hostitelem Hyper-V a je také serverem knihovny, tento příkaz odebere pouze funkce hostitele, ale ponechá funkci serveru knihovny na místě. To znamená, že hostitelský objekt se odebere z databáze VMM, ale software agenta VMM se z fyzického serveru neodinstaluje. Objekt serveru knihovny zůstává v databázi.

Pokud je hostitelem ESX, může fungovat pouze jako hostitel virtuálního počítače v nástroji VMM. Nemůže být hostitelem i serverem knihovny.

• Pověření. Pokud je hostitel Hyper-V připojený k doméně služby Active Directory, musíte zadat přihlašovací údaje pro účet s odpovídajícími oprávněními k odebrání tohoto hostitelského počítače z nástroje VMM.

K odebrání hostitele hraniční sítě, hostitele ESX nebo hostitele XenServer z nástroje VMM nemusíte zadávat přihlašovací údaje služby Active Directory.

• Virtual Machines. Když odeberete hostitele, nástroj VMM už hostitele nespravuje. Všechny virtuální počítače na hostitelském serveru se ale neodeberou ani neoddružují od serveru. Všechny spuštěné virtuální počítače se nevypnou. Přestože virtuální počítače již nejsou spravovány nástrojem VMM, nejsou ovlivněny žádným jiným způsobem.
• Vynucené odebrání. Parametr Force s rutinou Remove-SCVMHost můžete použít k odebrání hostitele virtuálního počítače z nástroje VMM, pokud nemáte odpovídající přihlašovací údaje ke správě daného hostitele nebo když server VMM už s tímto hostitelem nemůže komunikovat.

Když zadáte parametr Force , nástroj VMM nebude žádat ani kontrolovat přihlašovací údaje, ani se nástroj VMM pokusí připojit k hostiteli a odinstalovat agenta VMM. Proto se použití parametru Force doporučuje pouze při odebírání zastaralých záznamů hostitele z databáze VMM.

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na $True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání konkrétního hostitele připojeného k doméně z nástroje VMM

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

První příkaz používá rutinu Get-Credential k zobrazení výzvy k zadání uživatelského jména a hesla a uložení zadaných přihlašovacích údajů do proměnné $Credential. Požadované přihlašovací údaje pro tuto operaci jsou účet domény s právy správce k odebrání hostitelského serveru se systémem Windows připojeným k doméně služby Active Directory z nástroje VMM.

Druhý příkaz získá hostitelský objekt S názvem VMHost01 a uloží objekt do proměnné $VMHost.

Třetí příkaz odebere hostitelský objekt uložený v $VMHost. Při zpracování tohoto příkazu $Credential poskytuje přihlašovací údaje k nástroji Remove-VMHost a příkaz Potvrdit výzvu k potvrzení, že chcete odebrat tohoto hostitele z nástroje VMM.

Příklad 2: Odebrání všech hostitelů, kteří nejsou uzly v hostitelském clusteru z nástroje 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

První příkaz získá všechny hostitelské objekty, vyloučí všechny hostitele, které jsou uzly v hostitelském clusteru, vybere pouze ty objekty, které představují hostitele VMware ESX, hostitele hraniční sítě nebo nedůvěryhodné hostitele domény, a potom tyto objekty odebere z nástroje VMM, pokud potvrdíte, že je chcete odebrat. K odebrání těchto hostitelů se nevyžadují přihlašovací údaje.

Druhý příkaz vás vyzve k zadání uživatelského jména a hesla pro účet s oprávněními k odebrání hostitelů Windows připojených k doméně z nástroje VMM a uloží vaše přihlašovací údaje do $Credential.

Poslední příkaz získá všechny hostitelské objekty připojené k doméně, které nejsou součástí hostitelského clusteru, a předá objekty rutině Remove-VMHost . Jakmile se tento příkaz zpracuje, $Credential poskytne přihlašovací údaje pro Remove-VMHost a potvrzení parametru zobrazí výzvu k potvrzení, že chcete odebrat tyto hostitele z nástroje VMM.

Příklad 3: Odebrání konkrétního hostitele, ke kterému už nemáte přístup z nástroje VMM

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

První příkaz získá hostitelský objekt S názvem VMHost03 a uloží objekt do proměnné $VMHost.

Druhý příkaz přepne na parametr Force , aby se zajistilo, že se z databáze VMM odebere VMHost03. Pro tuto operaci nejsou potřeba přihlašovací údaje. Parametr Confirm vás vyzve k potvrzení, že chcete tohoto hostitele odebrat.

Poznámka: Parametr Vynucení můžete použít k odebrání hostitele z nástroje VMM, pokud nemáte přihlašovací údaje pro daného hostitele nebo když server VMM již nemůže komunikovat s tímto hostitelem.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje objekt přihlašovacích údajů nebo pro některé rutiny objekt účtu Spustit jako, který obsahuje uživatelské jméno a heslo účtu, který má oprávnění k provedení této akce. Nebo v případě restartování scJob má oprávnění k dokončení restartované úlohy.

Další informace o PSCredential objekt, zadejte Get-Help Get-Credential.

Další informace o účtech Spustit jako potřebujete, zadejte Get-Help New-SCRunAsAccount.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RemoveHostWithVMs

Další informace o PSCredential objekt, zadejte Get-Help Get-Credential.

Další informace o účtech Spustit jako potřebujete, zadejte Get-Help New-SCRunAsAccount.

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

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

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

-VMHost

Určuje objekt hostitele virtuálního počítače. Nástroj VMM podporuje hostitele Hyper-V, hostitele VMware ESX a hostitele Citrix XenServer.

Další informace o jednotlivých typech hostitelů najdete v rutině Add-SCVMHost .

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

-VMMServer

Určuje objekt serveru VMM.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Související odkazy

• 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