Sdílet prostřednictvím

Remove-SCVirtualScsiAdapter

  • Reference
Modul:
VirtualMachineManager

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

Syntax

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ě pouze 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ží objekt 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á alespoň 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 zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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ý identifikátor skupiny úloh.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualScsiAdapter

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

Typ počtu hostitelů 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.

Type:VirtualSCSIAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Poznámky

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