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 seine Einstellungen zu ändern.

Hinweis: Verwenden des ShareVirtualScsiAdapter-Parameters 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 freigegebenen 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 virtuelle Computerobjekt 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 variablen $VMTemplate.

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 namens 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 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:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Type:	HardwareProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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:	True
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.

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

-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 leistungsstarkes synthetisches Gerät ist. Erfordert ein Gastbetriebssystem, das die Virtualisierung unterstützt, auf der virtuellen Maschine.

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

Type:	Template
Aliases:	Template
Position:	Named
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-Computerobjekt, ein virtuelles Computervorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Cmdlets Get-SCVirtualMachine, Get-SCVMTemplate oder Get-SCHardwareProfile abgerufen werden kann.