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 mindestens ein virtuelles SCSI-Adapterobjekt aus einem virtuellen Computer, einer virtuellen Computervorlage oder einem Hardwareprofil, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird.

Das Cmdlet Remove-SCVirtualSCSIAdapter entfernt einen virtuellen SCSI-Adapter nur dann 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 zurück (mit der Eigenschaft MarkedForDeletion auf True festgelegt) oder eine Fehlermeldung beim Fehler zurück.

Beispiele

Beispiel 1: Entfernen des dritten virtuellen SCSI-Adapters von 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 mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

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 enthält.

Der letzte Befehl übergibt den dritten virtuellen SCSI-Adapter ($Adapter[2]) an Remove-SCVirtualScsiAdapter, der diesen virtuellen SCSI-Adapter von 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 Benutzer im 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 die Benutzerrolle im Namen der Benutzerrolle als die Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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 VMM SCSI-Adapterobjekt, das mithilfe des Cmdlets Get-SCVirtualScsiAdapter abgerufen werden kann.