Freigeben über

New-SCVirtualScsiAdapter

  • Referenz
Modul:
VirtualMachineManager

Erstellt einen virtuellen SCSI-Adapter auf einem virtuellen Computer, einer Virtuellen Computervorlage oder einem Hardwareprofil, das in VMM verwendet wird.

Syntax

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -JobGroup <Guid>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVirtualScsiAdapter erstellt einen virtuellen SCSI-Adapter auf einem virtuellen Computer, einer Virtuellen Computervorlage oder einem Hardwareprofil, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Nachdem Sie den virtuellen SCSI-Adapter erstellt haben, können Sie das cmdlet Set-SCVirtualScsiAdapter verwenden, um die zugehörigen Einstellungen zu ändern.

Hinweis: Verwenden des ShareVirtualScsiAdapter Parameter zum Freigeben eines virtuellen SCSI-Adapters auf einem virtuellen Computer, um gastclustering zu aktivieren, wird nur unterstützt, wenn der virtuelle Computer auf einem 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 gemeinsam genutzten Speicher verwendet.

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

Beispiele

Beispiel 1: Erstellen eines virtuellen SCSI-Adapters auf einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM

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 erstellt einen virtuellen SCSI-Adapter auf VM01.

Beispiel 2: Erstellen eines virtuellen SCSI-Adapters auf einer Vorlage für virtuelle Computer

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualScsiAdapter -VMTemplate $VMTemplate

Der erste Befehl ruft das VmTemplate01-Vorlagenobjekt des virtuellen Computers aus der VMM-Bibliothek ab und speichert das Objekt in der $VMTemplate Variablen.

Der zweite Befehl erstellt einen virtuellen SCSI-Adapter auf VMTemplate01.

Beispiel 3: Erstellen eines virtuellen SCSI-Adapters auf einem Hardwareprofil

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualScsiAdapter -HardwareProfile $HWProfile

Der erste Befehl ruft das Hardwareprofilobjekt "NewHWProfile01" aus der VMM-Bibliothek ab und speichert das Objekt in der $HWProfile Variablen.

Der zweite Befehl erstellt einen virtuellen SCSI-Adapter auf NewHWProfile01.

Parameter

-AdapterID

Gibt die logische Einheitennummer oder LUN-ID an. Hyper-V und XenServer machen diesen Wert nicht verfügbar, und er kann nicht geändert werden. Bei einem VMware ESX-Host ist der Standardwert 7 und kann nicht geändert werden.

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

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Typ:HardwareProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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:True
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

-ScsiControllerType

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

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Typ:VMSCSIControllerType
Zulässige Werte:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShareVirtualScsiAdapter

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

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

Hinweis: Beim Freigeben eines SCSI-Controllers auf einem virtuellen Computer auf einem ESX-Host verwendet VMM standardmäßig die SCSI-Freigaberichtlinie für VMware auf "physisch".

Typ:Boolean
Aliase:Shared
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Synthetic

Gibt an, dass ein Gerät, z. B. ein virtueller Netzwerkadapter, auf einem virtuellen Computer, der auf einem Hyper-V Host bereitgestellt wird, ein leistungsfähiges synthetisches Gerät ist. Erfordert ein virtualisierungsfähiges Gastbetriebssystem auf dem virtuellen Computer.

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

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.

Typ:Template
Aliase:Template
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualSCSIAdapter

Dieses Cmdlet gibt ein VirtualSCSIAdapter--Objekt zurück.

Hinweise

  • Erfordert ein VMM-Objekt, ein Vm-Vorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Get-SCVirtualMachine, Get-SCVMTemplate-oder Get-SCHardwareProfile Cmdlets abgerufen werden kann.