Remove-SCVMHost

Modul:

VirtualMachineManager

Odebere hostitele virtuálního počítače z nástroje VMM.

Syntaxe

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 objekt hostitele z databáze VMM a software agenta VMM se odinstaluje z fyzického hostitelského serveru.

Pokud je hostitel hostitelem VMware ESX nebo hostitelem Citrix XenServer, odebere se z databáze VMM objekt hostitele. Nástroj VMM neinstaluje agenta na hostitele ESX ani 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 je odebrán z databáze VMM, ale software agenta VMM není odinstalován z fyzického serveru. 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 se jednat o hostitele i server 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 příslušný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.

• Virtuální počítače. 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 už nástroj VMM nespravuje, nejsou ovlivněny žádným jiným způsobem.
• Vynucené odebrání. Parametr Force můžete použít s rutinou Remove-SCVMHost 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ž už server VMM nemůže s tímto hostitelem 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 při odebírání zastaralých záznamů hostitele z databáze VMM doporučuje použít parametr Force.

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 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á objekt hostitele s názvem VMHost01 a uloží objekt do proměnné $VMHost.

Třetí příkaz odebere objekt hostitele uložený v $VMHost. Při zpracování tohoto příkazu $Credential přihlašovací údaje pro remove-VMHosta Potvrdit parametr vás vyzve k potvrzení, že chcete tohoto hostitele odebrat 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 odebere tyto objekty z nástroje VMM, pokud potvrdíte, že je chcete odebrat. K odebrání těchto hostitelů nejsou vyžadovány 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 objekty hostitele připojené k doméně založené na Windows, které nejsou součástí hostitelského clusteru, a předá objekty rutině Remove-VMHost. Při zpracování tohoto příkazu $Credential přihlašovací údaje k Remove-VMHost a Potvrdit parametr vás vyzve k potvrzení, že chcete tyto hostitele odebrat 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á objekt hostitele s názvem VMHost03 a uloží objekt do proměnné $VMHost.

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

Poznámka: Parametr Force 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 s tímto hostitelem komunikovat.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Credential

Určuje objekt přihlašovacích údajů nebo u některých rutin 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ě restart-SCJobmá oprávnění k dokončení restartované úlohy.

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

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

Typ:	VMMCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RemoveHostWithVMs

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

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RunAsynchronously

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Host
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-VMMServer

Určuje objekt serveru VMM.

Typ:	ServerConnection
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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