Remove-SCVMTemplate
Remove um objeto de modelo do VMM.
Sintaxe
Default (Predefinição)
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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VMTemplate
Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.
Propriedades dos parâmetros
| Tipo: | Template |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Modelo |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Saídas
SCVMTemplate
Este cmdlet retorna um objeto SCVMTemplate .
Notas
- Requer um objeto de modelo do VMM, que pode ser recuperado usando o cmdlet Get-SCVMTemplate .