Condividi tramite

Remove-SCVMTemplate

  • Riferimento
Modulo:
VirtualMachineManager

Rimuove un oggetto modello da VMM.

Sintassi

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

Descrizione

Il cmdlet Remove-SCVMTemplate rimuove un oggetto modello dalla libreria Virtual Machine Manager (VMM). La rimozione di un oggetto modello non comporta l'eliminazione di dischi rigidi virtuali associati al modello.

I tipi di file che possono essere associati a un modello includono file su disco rigido virtuale (file VHD basati su Windows, file VHD basati su Citrix XenServer o file vmdk basati su VMware), file su disco floppy virtuale (file con estensione flp basati su Windows) e file script (file script Windows PowerShell .ps1 o script di file di risposte, inclusi Sysprep.inf e file Unattend.xml).

Se questo cmdlet ha esito positivo, restituisce l'oggetto con la proprietà MarkedForDeletion impostata su TRUE, se ha esito negativo restituisce un messaggio di errore.

Esempio

Esempio 1: Rimuovere un modello specifico dalla libreria

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

Il primo comando ottiene l'oggetto modello denominato Template01 dalla libreria in VMMServer01 e archivia l'oggetto nella variabile $Template.

Il secondo comando rimuove l'oggetto modello archiviato in $Template dalla libreria.

Esempio 2: Rimuovere tutti i modelli dalla libreria

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

Il primo comando ottiene tutti gli oggetti modello da VMMServer01 e archivia gli oggetti nella matrice denominata $Templates.

Il secondo comando passa ogni oggetto modello in $Templates al cmdlet Remove-SCVMTemplate , che rimuove ogni oggetto modello dalla libreria VMM. Il parametro Confirm richiede di confermare se si desidera eliminare ogni modello.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-VMTemplate

Specifica un oggetto modello VMM utilizzato per creare macchine virtuali.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Output

SCVMTemplate

Questo cmdlet restituisce un oggetto SCVMTemplate .

Note

  • Richiede un oggetto modello VMM, che può essere recuperato usando il cmdlet Get-SCVMTemplate .