Sdílet prostřednictvím

Remove-SCVirtualMachine

  • Reference
Modul:
VirtualMachineManager

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

Syntaxe

Remove-SCVirtualMachine
      [-VM] <VM>
      [-SkipFileRemoval]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Rutina Remove-SCVirtualMachine odebere objekt virtuálního počítače nasazený na hostiteli nebo uložený na serveru knihovny nástroje Virtual Machine Manager (VMM).

Tato rutina odstraní záznam virtuálního počítače z databáze VMM, odstraní všechny soubory přidružené k virtuálnímu počítači a odebere virtuální počítač z hostitele, na kterém je nasazený, nebo ze serveru knihovny, na kterém je uložený.

Pokud byla pro tento virtuální počítač vytvořena složka na hostiteli nástrojem VMM, ne pomocí Hyper-V nebo VMware a pokud tato složka neobsahuje žádné jiné virtuální počítače nebo jiná data, můžete pomocí systému souborů odstranit složku po odebrání virtuálního počítače.

Pokud zadáte parametr Force, tato rutina odstraní pouze virtuální počítač z databáze VMM. Neodstraní samotný virtuální počítač.

Tato rutina vrátí objekt po úspěchu, který má hodnotu $True pro vlastnost MarkedForDeletion. Pokud selže, rutina vrátí chybovou zprávu.

Příklady

Příklad 1: Odebrání konkrétního virtuálního počítače nasazeného na hostiteli

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM

První příkaz získá objekt virtuálního počítače s názvem VM01 nasazený na VMHost01 a pak uloží objekt virtuálního počítače do proměnné $VM.

Druhý příkaz odebere objekt uložený v $VM a odstraní odpovídající soubory virtuálního počítače ze systému souborů na svém hostiteli.

Příklad 2: Odebrání všech virtuálních počítačů s názvy, které obsahují určitý řetězec

PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine

První příkaz získá všechny objekty virtuálních počítačů nasazené na libovolném hostiteli, jehož název obsahuje řetězec virtuálního počítače VM0, a pak tyto objekty virtuálního počítače uloží do pole s názvem $VMs.

Druhý příkaz odebere každý objekt virtuálního počítače v poli $VMs a odstraní odpovídající soubory virtuálního počítače ze systému souborů na každém hostiteli.

Příklad 3: Odebrání konkrétního virtuálního počítače uloženého na serveru knihovny VMM

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM

První příkaz získá objekt, který představuje virtuální počítač s názvem VM03, a pak uloží objekt virtuálního počítače do $VM. V tomto příkladu existuje pouze jeden virtuální počítač s názvem VM03.

Druhý příkaz odebere objekt, který představuje virtuální počítač VM03 z knihovny, a odstraní odpovídající soubory virtuálního počítače ze systému souborů na serveru knihovny.

Příklad 4: Odebrání několika uložených virtuálních počítačů z knihovny VMM

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm

První příkaz získá všechny objekty virtuálního počítače, jejichž názvy zahrnují řetězec VM0 a které jsou uložené na LibraryServer01. Příkaz pak uloží objekty virtuálního počítače do pole s názvem $VMs.

Druhý příkaz předá každý objekt virtuálního počítače uložený v $VMs aktuální rutině, která odebere každý objekt z knihovny a odstraní odpovídající soubory virtuálního počítače ze systému souborů na serveru knihovny. Parametr Potvrdit vás vyzve k potvrzení, jestli chcete odstranit každý z těchto virtuálních počítačů.

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

-Force

Označuje, že tato rutina odstraní pouze virtuální počítač z databáze VMM. Neodstraní samotný virtuální počítač.

Poznámka

U virtuálních počítačů nasazených pomocí šablon služeb nebo VMRole se tento parametr ignoruje a skutečný virtuální počítač se také odstraní.

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

-JobVariable

Určuje proměnnou, ve které je průběh úlohy sledován a uložen.

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

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

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

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
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

-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

-SkipFileRemoval

Označuje, že tato rutina neodebere přímo soubory související s virtuálním počítačem. Pokud zadáte tento parametr, nebude proveden žádný pokus o odstranění žádných souborů přímo.

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

-VM

Určuje objekt virtuálního počítače.

Typ:VM
Position:0
Default value:None
Vyžadováno:True
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

Poznámky

Tato rutina vyžaduje objekt virtuálního počítače VMM, který lze načíst pomocí rutiny Get-SCVirtualMachine.