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 Virtual Machine Manager (VMM). A remoção de um objeto de modelo não elimina quaisquer discos rígidos virtuais associados ao modelo.

Os tipos de ficheiros que podem ser associados a um modelo incluem ficheiros de discos rígidos virtuais (ficheiros .vhd baseados no Windows, Ficheiros .vhd baseados em Citrix XenServer, ou ficheiros VMware .vmdk), ficheiros de discos virtuais floppy (ficheiros de discos baseados no Windows .vfd ou ficheiros .flp baseados em VMware) e ficheiros de script (Windows PowerShell .ps1 ficheiros de scripts ou ficheiros de resposta, incluindo ficheiros Sysprep.inf e Unattend.xml).

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para a substituição definida para TRUE) ou devolve 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 em VMMServer01 e armazena o objeto na variável $Template.

O segundo comando remove o objeto do 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 do modelo do VMMServer01 e armazena os objetos na matriz denominada $Templates.

O segundo comando passa cada objeto de modelo em $Templates para o cmdlet Remove-SCVMTemplate , que remove cada objeto de modelo da biblioteca VMM. O parâmetro Confirmar solicita-lhe que confirme se pretende eliminar cada modelo.

Parâmetros

-Confirm

Solicita a 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 funcionar sem pedir confirmação do utilizador.

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

-JobVariable

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

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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

Este cmdlet devolve um objeto SCVMTemplate .

Notas

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