Dela via

Remove-SCVirtualMachine

  • Referens
Modul:
VirtualMachineManager

Tar bort ett virtuellt datorobjekt från VMM.

Syntax

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

Description

Cmdleten Remove-SCVirtualMachine tar bort ett virtuellt datorobjekt som distribuerats på en värd eller lagras på en VMM-biblioteksserver (Virtual Machine Manager).

Den här cmdleten tar bort den virtuella datorposten från VMM-databasen, tar bort alla filer som är associerade med den virtuella datorn och tar bort den virtuella datorn från den värd där den distribueras eller från biblioteksservern där den lagras.

Om en mapp på en värd skapades för den här virtuella datorn av VMM, i stället för av Hyper-V eller VMware, och om mappen inte innehåller några andra virtuella datorer eller andra data, kan du använda filsystemet för att ta bort mappen när du har tagit bort den virtuella datorn.

Om du anger force-parametern tar den här cmdleten bara bort den virtuella datorn från VMM-databasen. Den tar inte bort själva den virtuella datorn.

Den här cmdleten returnerar objektet vid lyckat resultat som har värdet $True för egenskapen MarkedForDeletion . Om det misslyckas returnerar cmdleten ett felmeddelande.

Exempel

Exempel 1: Ta bort en specifik virtuell dator som distribuerats på en värd

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

Det första kommandot hämtar det virtuella datorobjektet VM01 som distribuerats på VMHost01 och lagrar sedan objektet för den virtuella datorn i variabeln $VM.

Det andra kommandot tar bort objektet som lagras i $VM och tar bort motsvarande virtuella datorfiler från filsystemet på värden.

Exempel 2: Ta bort alla virtuella datorer med namn som innehåller en specifik sträng

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

Det första kommandot hämtar alla virtuella datorobjekt som distribueras på alla värdar vars namn innehåller strängen VM0 och lagrar sedan dessa virtuella datorobjekt i matrisen med namnet $VMs.

Det andra kommandot tar bort varje virtuellt datorobjekt i $VMs-matrisen och tar bort motsvarande filer för virtuella datorer från filsystemet på varje värd.

Exempel 3: Ta bort en specifik virtuell dator som lagras på en VMM-biblioteksserver

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

Det första kommandot hämtar objektet som representerar den virtuella datorn med namnet VM03 och lagrar sedan objektet för den virtuella datorn i $VM. I det här exemplet finns det bara en virtuell dator med namnet VM03.

Det andra kommandot tar bort objektet som representerar VM03 från biblioteket och tar bort motsvarande filer för virtuella datorer från filsystemet på biblioteksservern.

Exempel 4: Ta bort flera lagrade virtuella datorer från VMM-biblioteket

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

Det första kommandot hämtar alla virtuella datorobjekt vars namn inkluderar strängen VM0 och som lagras på LibraryServer01. Kommandot lagrar sedan de virtuella datorobjekten i matrisen med namnet $VMs.

Det andra kommandot skickar varje virtuellt datorobjekt som lagras i $VMs till den aktuella cmdleten, som tar bort varje objekt från biblioteket och tar bort motsvarande virtuella datorfiler från filsystemet på biblioteksservern. Parametern Bekräfta uppmanar dig att bekräfta om du vill ta bort var och en av dessa virtuella datorer.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Force

Anger att den här cmdleten bara tar bort den virtuella datorn från VMM-databasen. Den tar inte bort själva den virtuella datorn.

Anteckning

För virtuella datorer som distribueras med hjälp av tjänstmallar eller VMRole ignoreras den här parametern och den faktiska virtuella datorn tas också bort.

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

-JobVariable

Anger en variabel där jobbstatus spåras och lagras.

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

-OnBehalfOfUser

Anger ett användarnamn. Den här cmdleten fungerar för användarens räkning som den här parametern anger.

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

-OnBehalfOfUserRole

Anger en användarroll. Om du vill hämta en användarroll använder du cmdleten Get-SCUserRole . Den här cmdleten fungerar för den användarroll som den här parametern anger.

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

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SkipFileRemoval

Anger att den här cmdleten inte tar bort filer som rör den virtuella datorn direkt. Om du anger den här parametern görs inget försök att ta bort filer direkt.

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

-VM

Anger ett virtuellt datorobjekt.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Kommentarer

Den här cmdleten kräver ett VMM-objekt för virtuella datorer som kan hämtas med hjälp av cmdleten Get-SCVirtualMachine .