Sdílet prostřednictvím

Remove-SCVMTemplate

  • Reference
Modul:
VirtualMachineManager

Odebere objekt šablony z nástroje VMM.

Syntax

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

Description

Rutina Remove-SCVMTemplate odebere objekt šablony z knihovny nástroje Virtual Machine Manager (VMM). Odebrání objektu šablony neodstraní žádné virtuální pevné disky přidružené k šabloně.

Typy souborů, které lze přidružit k šabloně, zahrnují soubory virtuálního pevného disku (soubory .vhd založené na Windows, soubory .vhd založené na systému Citrix XenServer nebo soubory VMware založené na .vmdk), soubory virtuální diskety (soubory .vfd založené na Windows nebo soubory .flp založené na VMware) a soubory skriptů (Windows PowerShell .ps1 skriptové soubory nebo skripty souborů odpovědí, včetně souborů Sysprep.inf a Unattend.xml souborů).

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na HODNOTU TRUE) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání konkrétní šablony z knihovny

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

První příkaz získá objekt šablony s názvem Template01 z knihovny na VMMServer01 a uloží objekt do proměnné $Template.

Druhý příkaz odebere objekt šablony uložený v $Template z knihovny.

Příklad 2: Odebrání všech šablon z knihovny

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

První příkaz získá všechny objekty šablony z VMMServer01 a uloží objekty do pole s názvem $Templates.

Druhý příkaz předá každý objekt šablony v $Templates rutině Remove-SCVMTemplate , která odebere každý objekt šablony z knihovny VMM. Parametr Confirm vás vyzve k potvrzení, jestli chcete odstranit každou šablonu.

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

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-VMTemplate

Určuje objekt šablony VMM použitý k vytvoření virtuálních počítačů.

Type:Template
Aliases:Template
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

Výstupy

SCVMTemplate

Tato rutina vrátí objekt SCVMTemplate .

Poznámky

  • Vyžaduje objekt šablony VMM, který lze načíst pomocí rutiny Get-SCVMTemplate .