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 cmdlet entfernt mindestens ein virtuelles SCSI-Adapterobjekt von 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ätegebundenen 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 bei Einem Fehler eine Fehlermeldung 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 Objekt des virtuellen Computers 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. Ein virtueller Computer kann bis zu vier virtuelle SCSI-Adapter angeschlossen haben. In diesem Beispiel wird davon ausgegangen, dass VM01 über mindestens drei virtuelle SCSI-Adapter verfügt.

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Mit diesem Cmdlet wird die Im Auftrag der Benutzerrolle als Benutzerrolle festgelegt, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualScsiAdapter

Gibt ein virtuelles SCSI-Adapterobjekt für einen virtuellen Computer an.

Typ der Hostnummer virtueller SCSI-Adapter

Hyper-V: Bis zu vier synthetische virtuelle SCSI-Adapter pro VM und bis zu 64 Geräte pro Adapter. Unterstützt eine Größe des virtuellen Datenträgers bis zu 2040 GB. Unterstützt keine emulierten virtuellen SCSI-Adapter. VMware ESX: Bis zu vier virtuelle SCSI-Adapter pro VM und bis zu 15 Geräte pro Adapter. Unterstützt eine Größe des virtuellen Datenträgers bis zu 2048 GB. Citrix XenServer: Immer ein virtueller SCSI-Adapter pro VM und bis zu acht Geräte pro Adapter. Unterstützt eine Größe des virtuellen Datenträgers bis zu 2048 GB.

Typ:VirtualSCSIAdapter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

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