Remove-SCVMTemplate
Quita un objeto de plantilla de VMM.
Sintaxis
Default (Es el valor predeterminado).
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). La eliminación de 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 disquete virtual (archivos .vfd basados en Windows o archivos .flp basados en VMware) y archivos de script (archivos de script de .ps1 de Windows PowerShell o scripts de archivos de respuesta, incluidos los archivos Sysprep.inf y Unattend.xml).
Este cmdlet devuelve el objeto en caso de éxito (con la propiedad MarkedForDeletion establecida en TRUE) o devuelve un mensaje de error en caso de error.
Ejemplos
Ejemplo 1: Eliminar 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 de VMMServer01 y almacena el objeto en la variable $Template.
El segundo comando elimina el objeto de plantilla almacenado en $Template de la biblioteca.
Ejemplo 2: Eliminar 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 en 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que este progreso se almacena en la variable denominada por este parámetro.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-VMTemplate
Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.
Propiedades del parámetro
| Tipo: | Template |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Plantilla |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Salidas
SCVMTemplate
Este cmdlet devuelve un objeto SCVMTemplate .
Notas
- Requiere un objeto de plantilla VMM, que se puede recuperar mediante el cmdlet Get-SCVMTemplate .