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 .