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

Remove-SCGuestOSProfile

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

Удаляет объект профиля гостевой операционной системы из VMM.

Синтаксис

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-SCGuestOSProfile удаляет один или несколько объектов профиля гостевой операционной системы из библиотеки VMM.

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

Примеры

Пример 1. Удаление определенного профиля гостевой операционной системы из библиотеки

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

Первая команда получает объект профиля гостевой операционной системы с именем NewOSProfile01 и сохраняет объект в переменной $OSProfile.

Вторая команда удаляет профиль гостевой операционной системы, хранящийся в $OSProfile, запрашивая подтверждение перед завершением операции.

Пример 2. Удаление всех профилей операционной системы без запроса на подтверждение каждого удаления

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

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

Вторая команда передает каждый объект в $OSProfiles командлету Remove-OSProfile, который удаляет каждый из объектов профиля гостевой операционной системы из библиотеки VMM.

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GuestOSProfile

Указывает объект профиля гостевой операционной системы.

Тип:GuestOSProfile
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-JobVariable

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

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

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Примечания

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