Remove-SCVirtualHardDisk

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

Синтаксис

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

Remove-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-JobGroup <Guid>]
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Remove-SCVirtualHardDisk удаляет объект виртуального жесткого диска из виртуальной машины или шаблона, а также из библиотеки диспетчера виртуальных машин (VMM). Remove-VirtualHardDisk также удаляет соответствующий файл виртуального жесткого диска (VHD-файл для Windows, VHD-файл для Citrix XenServer или VMDK-файл для VMware) с сервера библиотеки.

Если виртуальный жесткий диск подключен к виртуальному диску на виртуальной машине или шаблоне (и если вы не используете параметр Принудительно ), VMM выводит список контейнера, содержащего виртуальный жесткий диск, и предлагает вам подтвердить, что вы хотите удалить виртуальный жесткий диск:

  • Если вы ответите «Да», VMM удалит связь между виртуальным жестким диском и контейнером, к которому он подключен, а затем удалит объект виртуального жесткого диска из VMM.

  • Если вы ответите «Нет», операция будет отменена.

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

Примеры

Пример 1: Удаление объекта виртуального жесткого диска из библиотеки

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

Первая команда получает объект виртуального жесткого диска с именем VHD01.vhd, хранящийся на LibraryServer01, и сохраняет возвращенный объект в переменной $VHD.

Вторая команда удаляет из библиотеки хранящийся в $VHD объект виртуального жесткого диска и удаляет соответствующий файл из файловой системы на сервере библиотеки.

Пример 2: Извлечение виртуального жесткого диска из виртуальной машины

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

Первая команда подключается к VMMServer01.

Вторая команда получает объект виртуальной машины с именем VM01, получает все виртуальные жесткие диски на VM01, имя которых включает строку "DataDisk", а затем сохраняет эти объекты виртуальных жестких дисков в массиве с именем $VHD.

Третья команда удаляет все объекты виртуального жесткого диска, хранящиеся в массиве $VHD, с виртуальной машины и удаляет каждый соответствующий файл из файловой системы на сервере библиотеки.

Параметры

-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

-JobGroup

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

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

Тип:Guid
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

-VirtualHardDisk

Указывает объект виртуального жесткого диска.

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

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

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

(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.

Примечания

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