Поделиться через

Remove-SCVMTemplate

  • Ссылка
Модуль:
VirtualMachineManager

Удаляет объект шаблона из VMM.

Синтаксис

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

Описание

Командлет Remove-SCVMTemplate удаляет объект шаблона из библиотеки Virtual Machine Manager (VMM). Удаление объекта шаблона не приводит к удалению виртуальных жестких дисков, связанных с шаблоном.

Типы файлов, которые могут быть связаны с шаблоном, включают файлы виртуальных жестких дисков (VHD-файлы на основе Windows, VHD-файлы на основе Citrix XenServer или VMware-файлы vmdk), файлы виртуальных дисков floppy (VFD-файлы на основе Windows или FLP-файлы на основе VMware) и файлы скриптов (Windows PowerShell .ps1 файлы скриптов или скрипты ответов, включая Sysprep.inf и Unattend.xml файлы).

Этот командлет возвращает объект после успешного выполнения (со свойством MarkedForDeletion с значением TRUE) или возвращает сообщение об ошибке при сбое.

Примеры

Пример 1. Удаление определенного шаблона из библиотеки

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

Первая команда получает объект шаблона с именем Template01 из библиотеки в VMMServer01 и сохраняет объект в переменной $Template.

Вторая команда удаляет объект шаблона, хранящийся в $Template из библиотеки.

Пример 2. Удаление всех шаблонов из библиотеки

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

Первая команда получает все объекты шаблона из VMMServer01 и сохраняет объекты в массиве с именем $Templates.

Вторая команда передает каждый объект шаблона в $Templates командлету Remove-SCVMTemplate , который удаляет каждый объект шаблона из библиотеки VMM. Параметр Confirm запрашивает подтверждение удаления каждого шаблона.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

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

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре.

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

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проводить аудит советов PRO.

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

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы управление немедленно возвращалось в командную оболочку.

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

-VMTemplate

Указывает объект шаблона VMM, используемый для создания виртуальных машин.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Выходные данные

SCVMTemplate

Этот командлет возвращает объект SCVMTemplate .

Примечания

  • Требуется объект шаблона VMM, который можно получить с помощью командлета Get-SCVMTemplate .