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 di disco rigido virtuale (file VHD basati su Windows, file VHD basati su Citrix XenServer o file con estensione vmdk basati su VMware), file su disco floppy virtuale (file con estensione vfd basati su Windows o file con estensione flp basati su VMware) e file di script (file script di windows PowerShell .ps1 file script o script di risposte, inclusi Sysprep.inf e Unattend.xml file).

Questo cmdlet restituisce l'oggetto in caso di esito positivo (con la proprietà MarkedForDeletion impostata su TRUE) o restituisce un messaggio di errore in caso 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 conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMTemplate

Specifica un oggetto modello VMM usato per creare macchine virtuali.

Tipo:Template
Alias:Template
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

SCVMTemplate

Questo cmdlet restituisce un oggetto SCVMTemplate.

Note

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