Remove-SCVirtualScsiAdapter

Удаляет объект виртуального адаптера SCSI из VMM.

Синтаксис

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

Remove-SCVirtualScsiAdapter
    [-VirtualScsiAdapter] <VirtualSCSIAdapter>
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Описание

Командлет Remove-SCVirtualScsiAdapter удаляет один или несколько объектов виртуального адаптера SCSI из виртуальной машины, шаблона виртуальной машины или профиля оборудования, используемого в среде диспетчера виртуальных машин (VMM).

Командлет Remove-SCVirtualSCSIAdapter успешно удаляет виртуальный адаптер SCSI только в том случае, если к нему не подключены устройства.

Виртуальная машина на узле Citrix XenServer всегда имеет один виртуальный адаптер SCSI. Вы не можете снять этот адаптер.

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

Примеры

Пример 1: Удаление третьего виртуального адаптера SCSI с виртуальной машины

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapter

Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.

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

Последняя команда передает третий виртуальный адаптер SCSI ($Adapter[2]) в Remove-SCVirtualScsiAdapter, который удаляет этот виртуальный адаптер SCSI из VM01.

Параметры

-Confirm

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

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

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

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

(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

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет задает от имени пользователя, указанного этим параметром.

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

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

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

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

-OnBehalfOfUserRole

Указывает роль пользователя. Этот командлет задает от имени роли пользователя роль пользователя в качестве роли пользователя, указанной этим параметром. Чтобы получить объект роли пользователя, используйте командлет Get-SCUserRole.

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

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

-VirtualScsiAdapter

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

Тип хоста Количество виртуальных адаптеров SCSI

Hyper-V: до четырех адаптеров искусственного виртуального SCSI на виртуальную машину и до 64 устройств на адаптер. Поддерживает виртуальный диск размером до 2040 ГБ. Не поддерживает эмулированные виртуальные адаптеры SCSI. VMware ESX: до четырех виртуальных адаптеров SCSI на виртуальную машину и до 15 устройств на адаптер. Поддерживает виртуальный диск размером до 2048 ГБ. Citrix XenServer: всегда один виртуальный адаптер SCSI на виртуальную машину и до восьми устройств на адаптер. Поддерживает виртуальный диск размером до 2048 ГБ.

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

Тип:VirtualSCSIAdapter
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 SCSI, который можно получить с помощью командлета Get-SCVirtualScsiAdapter .