Compartilhar 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 VMM (Virtual Machine Manager). A remoção de um objeto de modelo não exclui discos rígidos virtuais associados 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 em Citrix XenServer ou arquivos .vmdk baseados em VMware), arquivos de disco disquete virtual (arquivos .vfd baseados no Windows ou arquivos .flp baseados em VMware) e arquivos de script (o Windows PowerShell .ps1 arquivos de script ou scripts de arquivo de resposta, incluindo arquivos Sysprep.inf e Unattend.xml).

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como TRUE) ou retorna uma mensagem de erro após 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 Confirme solicita que você confirme se deseja excluir cada modelo.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMTemplate

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

Tipo:Template
Aliases:Template
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

SCVMTemplate

Esse cmdlet retorna um objeto SCVMTemplate.

Observações

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