Compartir a través de

Remove-SCVMTemplate

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de plantilla de VMM.

Syntax

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). Al quitar un objeto de plantilla no se eliminan los discos duros virtuales asociados 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 de disquete virtual (archivos .vfd basados en Windows o archivos .flp basados en VMware) y archivos de script (archivos de script Windows PowerShell .ps1 o scripts de archivo de respuesta, incluidos sysprep.inf y archivos de Unattend.xml).

Este cmdlet devuelve el objeto si la operación se realiza correctamente (con la propiedad MarkedForDeletion establecida en TRUE) o devuelve un mensaje de error si se produce 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 solicita su confirmación antes de ejecutar el cmdlet.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VMTemplate

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .