Freigeben über

Remove-SCVirtualScsiAdapter

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein virtuelles SCSI-Adapterobjekt aus VMM.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCVirtualSCSIAdapter entfernt eine oder mehrere virtuelle SCSI-Adapterobjekte aus einer virtuellen Computer-, virtuellen Computervorlage oder hardwareprofil, die in einer Virtual Machine Manager -Umgebung (VMM) verwendet wird.

Das Cmdlet Remove-SCVirtualSCSIAdapter entfernt einen virtuellen SCSI-Adapter erfolgreich, wenn der Adapter keine Geräte enthält.

Ein virtueller Computer auf einem Citrix XenServer-Host verfügt immer über einen virtuellen SCSI-Adapter. Sie können diesen Adapter nicht entfernen.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf "True" festgelegt) zurück oder gibt eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen des dritten virtuellen SCSI-Adapters aus einem virtuellen Computer

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

Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft alle virtuellen SCSI-Adapterobjekte auf VM01 ab und speichert die Objekte im $Adapter-Objektarray. Mit einer virtuellen Maschine können bis zu vier virtuelle SCSI-Adapter verbunden sein. In diesem Beispiel wird davon ausgegangen, dass VM01 mindestens drei virtuelle SCSI-Adapter aufweist.

Der letzte Befehl übergibt den dritten virtuellen SCSI-Adapter ($Adapter[2]) an Remove-SCVirtualSCSIAdapter, der diesen virtuellen SCSI-Adapter aus VM01 entfernt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-OnBehalfOfUser

Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Namen des Benutzers als Benutzer fest, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Dieses Cmdlet legt den Namen der Benutzerrolle als Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrolleobjekts das Cmdlet Get-SCUserRole .

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VirtualScsiAdapter

Gibt ein virtuelles SCSI-Adapterobjekt für eine virtuelle Maschine an.

Typ der Hostnummer von virtuellen SCSI-Adaptern

Hyper-V: Bis zu vier synthetische virtuelle SCSI-Adapter pro VM und bis zu 64 Geräte pro Adapter. Unterstützt für virtuelle Laufwerke eine Größe von bis zu 2040 GB. Emulierte virtuelle SCSI-Adapter werden nicht unterstützt. VMware ESX: Bis zu vier virtuelle SCSI-Adapter pro VM und bis zu 15 Geräte pro Adapter. Unterstützt für virtuelle Laufwerke eine Größe von bis zu 2048 GB. Citrix XenServer: Immer ein virtueller SCSI-Adapter pro VM und bis zu acht Geräte pro Adapter. Unterstützt für virtuelle Laufwerke eine Größe von bis zu 2048 GB.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Hinweise

  • Erfordert ein virtuelles SCSI-Adapterobjekt, das mithilfe des Cmdlets Get-SCVirtualScsiAdapter abgerufen werden kann.