Compartir a través de

Remove-SCVMTemplate

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de plantilla de VMM.

Sintaxis

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

Description

El cmdlet Remove-SCVMTemplate quita un objeto de plantilla de la biblioteca de Virtual Machine Manager (VMM). Quitar un objeto de plantilla no elimina ningún disco duro virtual asociado a la plantilla.

Los tipos de archivos que se pueden asociar a una plantilla incluyen archivos de disco duro virtual (archivos .vhd basados en Windows, archivos .vhd basados en Citrix XenServer o archivos .vmdk basados en VMware), archivos de disco virtual (archivos .vfd basados en Windows o archivos .flp basados en VMware) y archivos de script (archivos de script de Windows PowerShell .ps1 archivos de script o scripts de respuesta, incluidos sysprep.inf y archivos de Unattend.xml).

Este cmdlet devuelve el objeto tras el éxito (con la propiedad MarkedForDeletion establecida en TRUE) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Quitar una plantilla específica de la biblioteca

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

El primer comando obtiene el objeto de plantilla denominado Template01 de la biblioteca en VMMServer01 y almacena el objeto en la variable $Template.

El segundo comando quita el objeto de plantilla almacenado en $Template de la biblioteca.

Ejemplo 2: Quitar todas las plantillas de la biblioteca

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

El primer comando obtiene todos los objetos de plantilla de VMMServer01 y almacena los objetos de la matriz denominada $Templates.

El segundo comando pasa cada objeto de plantilla de $Templates al cmdlet Remove-SCVMTemplate , que quita cada objeto de plantilla de la biblioteca VMM. El parámetro Confirm le pide que confirme si desea eliminar cada plantilla.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMTemplate

Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.

Tipo:Template
Alias:Template
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

SCVMTemplate

Este cmdlet devuelve un objeto SCVMTemplate.

Notas

  • Requiere un objeto de plantilla VMM, que se puede recuperar mediante el cmdlet Get-SCVMTemplate.