Remove-SCVMTemplate

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

Синтаксис

Default (по умолчанию)

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

Описание

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

Типы файлов, которые могут быть связаны с шаблоном, включают файлы виртуального жесткого диска (файлы .vhd на основе Windows, файлы .vhd на основе Citrix XenServer или файлы .vmdk на основе VMware), файлы виртуальных дискет (файлы .vfd на основе Windows или файлы .flp на основе VMware) и файлы сценариев (файлы сценариев .ps1 Windows PowerShell или сценарии файлов ответов, включая файлы 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

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMTemplate

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

Свойства параметра

Тип:Template
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Шаблон

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

SCVMTemplate

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

Примечания

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