Remove-SCVMTemplate

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de modelo do VMM.

Syntax

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 disquete virtual (arquivos .vfd baseados em Windows ou arquivos .flp baseados em VMware) e arquivos de script (arquivos de script Windows PowerShell .ps1 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 a 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 sua confirmação antes de executar o cmdlet.

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

-Force

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

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

-JobVariable

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VMTemplate

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

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

-WhatIf

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

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