Set-SCVirtualScsiAdapter

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines virtuellen SCSI-Adapters, der in VMM verwendet wird.

Syntax

Set-SCVirtualScsiAdapter
   [-ScsiControllerType <VMSCSIControllerType>]
   [-VirtualScsiAdapter] <VirtualSCSIAdapter>
   [-AdapterID <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCVirtualScsiAdapter ändert eine oder mehrere Eigenschaften eines virtuellen SCSI-Adapters, der in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Einstellungen, die Sie ändern können, umfassen die Angabe, ob ein virtueller SCSI-Adapter freigegeben und die Adapter-ID festgelegt wird.

Hinweis: Verwenden des Parameters ShareVirtualScsiAdapter zum Freigeben eines virtuellen SCSI-Adapters auf einem virtuellen Computer, um Gastclustering zu aktivieren, wird nur unterstützt, wenn der virtuelle Computer auf einem VMware ESX-Host bereitgestellt wird. Der Parameter SharedVirtualScsiAdapter wird für einen virtuellen Computer auf einem Hyper-V-Host nicht verwendet, da ein virtueller Computer auf einem Hyper-V-Host iSCSI für freigegebenen Speicher verwendet.

Hinweis: Set-SCVirtualScsiAdapter wird nicht für Citrix XenServer-Hosts verwendet, da der SCSI-Adapter auf virtuellen Citrix XenServer-Computern nicht konfigurierbar ist.

Beispiele

Beispiel 1: Freigeben eines bestimmten virtuellen SCSI-Adapters auf einem virtuellen Computer, um ihn für Gastclustering zu aktivieren

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualScsiAdapter -VM $VM 
PS C:\> Set-SCVirtualSCSIAdapter -VirtualScsiAdapter $Adapter -ShareVirtualScsiAdapter $True

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das SCSI-Adapterobjekt auf VM01 ab und speichert das Objekt in der $Adapter Variablen. In diesem Beispiel wird davon ausgegangen, dass VM01 über einen virtuellen SCSI-Adapter verfügt. Ein virtueller Computer kann jedoch bis zu vier virtuelle SCSI-Adapter angeschlossen haben.

Der letzte Befehl aktiviert das in $Adapter gespeicherte virtuelle SCSI-Adapterobjekt und gibt an, dass es freigegeben ist, damit es in Gastclustering verwendet werden kann.

Hinweis: Verwenden des Shared-Parameters zum Freigeben eines virtuellen SCSI-Adapters auf einem virtuellen Computer wird nur unterstützt, wenn der virtuelle Computer auf einem ESX-Host bereitgestellt wird. Der Parameter Shared wird für einen virtuellen Computer nicht für einen Hyper-V-Host verwendet, da ein virtueller Computer auf einem Hyper-V-Host iSCSI für freigegebenen Speicher verwendet. Der Parameter Shared wird auch nicht für einen virtuellen Computer auf einem XenServer-Host verwendet, da XenServer-basierte virtuelle Computer immer genau einen SCSI-Adapter haben.

Parameter

-AdapterID

Gibt die Wahrheitseinheitsnummer oder LUN-ID an. Hyper-V und XenServer machen diesen Wert nicht verfügbar, und es kann nicht geändert werden. Für einen VMware ESX-Host ist der Standardwert 7 und kann nicht geändert werden.

Type:Byte
Position:Named
Default value:None
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

-ScsiControllerType

Gibt einen SCSI-Controllertyp an. Gültige Werte sind:

  • Defaulttype
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Accepted values:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareVirtualScsiAdapter

Gibt an, ob ein virtueller SCSI-Adapter freigegeben wird, damit er in Gastclustering verwendet werden kann.

Hosttyp: Hyper-V-Host verwendet diesen Parameter:

  • Hyper-V-Host: Nein (für Gastclustering, iSCSI-Speicher verwenden)
  • XenServer-Host: Nein (Xen VMs haben immer genau einen SCSI-Adapter)

Hinweis: Wenn Sie einen SCSI-Controller auf einem virtuellen Computer auf einem ESX-Host freigeben, legt VMM die SCSI-Freigaberichtlinie für VMware auf "physisch" fest.

Type:Boolean
Aliases:Shared
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

Ausgaben

VirtualSCSIAdapter

Dieses Cmdlet gibt ein VirtualScsiAdapter -Objekt zurück.

Hinweise

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