Partilhar via

Remove-SCVMTemplate

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de modelo do VMM.

Sintaxe

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

Description

O cmdlet Remove-SCVMTemplate remove um objeto de modelo da biblioteca do Virtual Machine Manager (VMM). A remoção de um objeto de modelo não exclui nenhum disco rígido virtual associado ao modelo.

Os tipos de arquivos que podem ser associados a um modelo incluem arquivos de disco rígido virtual (arquivos .vhd baseados no Windows, arquivos .vhd baseados no Citrix XenServer ou arquivos .vmdk baseados em VMware), arquivos de disquete virtual (arquivos .vfd baseados no Windows ou arquivos .flp baseados em VMware) e arquivos de script (arquivos de script do Windows PowerShell .ps1 ou scripts de arquivo de resposta, incluindo arquivos Sysprep.inf e Unattend.xml).

Este cmdlet retorna o objeto em caso de êxito (com a propriedade MarkedForDeletion definida como TRUE) ou retorna uma mensagem de erro em caso de falha.

Exemplos

Exemplo 1: Remover um modelo específico da biblioteca

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

O primeiro comando obtém o objeto de modelo chamado Template01 da biblioteca no VMMServer01 e armazena o objeto na variável $Template.

O segundo comando remove o objeto de modelo armazenado em $Template da biblioteca.

Exemplo 2: Remover todos os modelos da biblioteca

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

O primeiro comando obtém todos os objetos de modelo do VMMServer01 e armazena os objetos na matriz chamada $Templates.

O segundo comando passa cada objeto de modelo em $Templates para o cmdlet Remove-SCVMTemplate, que remove cada objeto de modelo da biblioteca do VMM. O parâmetro Confirm solicita que você confirme se deseja excluir cada modelo.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Tipo:Template
Aliases:Template
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

SCVMTemplate

Este cmdlet retorna um SCVMTemplate objeto.

Notas

  • Requer um objeto de modelo do VMM, que pode ser recuperado usando o cmdlet Get-SCVMTemplate.