Sdílet prostřednictvím

Remove-SCVirtualMachine

  • Reference
Modul:
VirtualMachineManager

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

Syntax

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, nikoli technologií 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 pouze odstraní 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í konkrétní ř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ího počítače nasazené na libovolném hostiteli, jehož název obsahuje řetězec virtuálního počítače0, 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í více 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 Confirm 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 zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 rolí virtuálních počítačů se tento parametr ignoruje a skutečný virtuální počítač se také odstraní.

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

-JobVariable

Určuje proměnnou, ve které se sleduje a ukládá průběh úlohy.

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina pracuje jménem role uživatele, kterou tento parametr určuje.

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

-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

-SkipFileRemoval

Označuje, že tato rutina neodebere přímo soubory související s virtuálními počítači. Pokud zadáte tento parametr, nedojde k přímému pokusu o odstranění žádných souborů.

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

-VM

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

Type:VM
Position:0
Default value:None
Required:True
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

Poznámky

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