Sdílet prostřednictvím

Remove-SCVirtualScsiAdapter

  • Reference
Modul:
VirtualMachineManager

Odebere objekt virtuálního adaptéru SCSI z nástroje VMM.

Syntaxe

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

Description

Rutina Remove-SCVirtualScsiAdapter odebere jeden nebo více objektů adaptéru SCSI z virtuálního počítače, šablony virtuálního počítače nebo hardwarového profilu používaného v prostředí nástroje Virtual Machine Manager (VMM).

Rutina Remove-SCVirtualSCSIAdapter odebere virtuální adaptér SCSI úspěšně jenom v případě, že k němu adaptér nemá připojená žádná zařízení.

Virtuální počítač na hostiteli Citrix XenServer má vždy jeden virtuální adaptér SCSI. Tento adaptér nelze odebrat.

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na Hodnotu True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání třetího virtuálního adaptéru SCSI z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý příkaz získá všechny objekty adaptéru SCSI na virtuálním počítači VM01 a uloží objekty do pole objektů $Adapter. Virtuální počítač může mít připojené až čtyři virtuální adaptéry SCSI. Tento příklad předpokládá, že virtuální počítač VM01 má aspoň tři virtuální adaptéry SCSI.

Poslední příkaz předá třetí virtuální adaptér SCSI ($Adapter[2]) Remove-SCVirtualScsiAdapter, který odebere tento virtuální adaptér SCSI z virtuálního počítače VM01.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje jméno uživatele. Tato rutina nastaví jménem uživatele jako uživatele, který určuje tento parametr.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Tato rutina nastaví roli uživatele jménem uživatele jako roli uživatele, kterou tento parametr určuje. K získání objektu role uživatele použijte rutinu Get-SCUserRole.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualScsiAdapter

Určuje objekt virtuálního adaptéru SCSI pro virtuální počítač.

Typ hostitelského počtu virtuálních adaptérů SCSI

Hyper-V: Až čtyři syntetické virtuální adaptéry SCSI na virtuální počítač a až 64 zařízení na adaptér. Podporuje velikost virtuální diskové jednotky až 2040 GB. Nepodporuje emulované virtuální adaptéry SCSI. VMware ESX: Až čtyři virtuální adaptéry SCSI na virtuální počítač a až 15 zařízení na adaptér. Podporuje velikost virtuální diskové jednotky až 2048 GB. Citrix XenServer: Vždy jeden virtuální adaptér SCSI na virtuální počítač a až osm zařízení na adaptér. Podporuje velikost virtuální diskové jednotky až 2048 GB.

Typ:VirtualSCSIAdapter
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Poznámky

  • Vyžaduje objekt virtuálního adaptéru SCSI VMM, který lze načíst pomocí rutiny Get-SCVirtualScsiAdapter.