Dela via


Remove-SCVMTemplate

Tar bort ett mallobjekt från VMM.

Syntax

Remove-SCVMTemplate
      [-VMTemplate] <Template>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-SCVMTemplate tar bort ett mallobjekt från VMM-biblioteket (Virtual Machine Manager). Om du tar bort ett mallobjekt tas inga virtuella hårddiskar som är associerade med mallen bort.

De typer av filer som kan associeras med en mall är virtuella hårddiskfiler (Windows-baserade .vhd-filer, Citrix XenServer-baserade .vhd-filer eller VMware-baserade .vmdk-filer), virtuella diskettdiskfiler (Windows-baserade .vfd-filer eller VMware-baserade .flp-filer) och skriptfiler (Windows PowerShell .ps1 skriptfiler eller svarsfilskript, inklusive Sysprep.inf och Unattend.xml filer).

Den här cmdleten returnerar objektet när det lyckas (med egenskapen MarkedForDeletion inställd på TRUE) eller returnerar ett felmeddelande vid fel.

Exempel

Exempel 1: Ta bort en specifik mall från biblioteket

PS C:\> $Template = Get-SCVMTemplate -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Template01" }
PS C:\> Remove-SCVMTemplate -VMTemplate $Template

Det första kommandot hämtar mallobjektet Template01 från biblioteket på VMMServer01 och lagrar objektet i variabeln $Template.

Det andra kommandot tar bort mallobjektet som lagras i $Template från biblioteket.

Exempel 2: Ta bort alla mallar från biblioteket

PS C:\> $Templates = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Templates | Remove-SCVMTemplate -Confirm

Det första kommandot hämtar alla mallobjekt från VMMServer01 och lagrar objekten i matrisen med namnet $Templates.

Det andra kommandot skickar varje mallobjekt i $Templates till cmdleten Remove-SCVMTemplate, som tar bort varje mallobjekt från VMM-biblioteket. Parametern Confirm uppmanar dig att bekräfta om du vill ta bort varje mall.

Parametrar

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMTemplate

Anger ett VMM-mallobjekt som används för att skapa virtuella datorer.

Typ:Template
Alias:Template
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

SCVMTemplate

Den här cmdleten returnerar ett SCVMTemplate- objekt.

Kommentarer

  • Kräver ett VMM-mallobjekt som kan hämtas med hjälp av cmdleten Get-SCVMTemplate.