Sdílet prostřednictvím

Remove-SCVMTemplate

  • Reference
Modul:
VirtualMachineManager

Odebere objekt šablony z nástroje VMM.

Syntaxe

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ě.

Mezi typy souborů, které lze přidružit k šabloně, patří soubory virtuálního pevného disku (soubory .vhd založené na Windows, soubory .vhd založené na Citrix XenServeru nebo soubory VMware .vmdk), soubory virtuální diskety (soubory .vfd založené na Windows nebo soubory .flp založené na VMware) a soubory skriptů (soubory skriptu windows PowerShellu .ps1 skripty nebo soubory 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 $Template proměnné.

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 Potvrdit vás vyzve k potvrzení, jestli chcete odstranit každou šablonu.

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

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

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, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

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

-VMTemplate

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

Typ:Template
Aliasy:Template
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

Výstupy

SCVMTemplate

Tato rutina vrátí objekt SCVMTemplate.

Poznámky

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