Delen via

New-SCVirtualScsiAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een virtuele SCSI-adapter op een virtuele machine, virtuele-machinesjabloon of hardwareprofiel dat in VMM wordt gebruikt.

Syntaxis

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>]

Description

De New-SCVirtualScsiAdapter cmdlet maakt een virtuele SCSI-adapter op een virtuele machine, virtuele-machinesjabloon of hardwareprofiel dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager). Nadat u de virtuele SCSI-adapter hebt gemaakt, kunt u de cmdlet Set-SCVirtualScsiAdapter gebruiken om de instellingen te wijzigen.

Opmerking: het gebruik van de parameter ShareVirtualScsiAdapter om een virtuele SCSI-adapter op een virtuele machine te delen om gastclustering in te schakelen, wordt alleen ondersteund als de virtuele machine is geïmplementeerd op een ESX-host. De parameter SharedVirtualScsiAdapter wordt niet gebruikt voor een virtuele machine op een Hyper-V host, omdat een virtuele machine op een Hyper-V host iSCSI gebruikt voor gedeelde opslag.

Een virtuele machine op een Citrix XenServer-host heeft altijd één virtuele SCSI-adapter. U kunt deze adapter niet verwijderen of extra adapters toevoegen.

Voorbeelden

Voorbeeld 1: Een virtuele SCSI-adapter maken op een virtuele machine

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht maakt u een virtuele SCSI-adapter op VM01.

Voorbeeld 2: Een virtuele SCSI-adapter maken op een virtuele-machinesjabloon

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

Met de eerste opdracht wordt het sjabloonobject van de virtuele machine met de naam VMTemplate01 opgehaald uit de VMM-bibliotheek en wordt het object opgeslagen in de $VMTemplate variabele.

Met de tweede opdracht maakt u een virtuele SCSI-adapter op VMTemplate01.

Voorbeeld 3: Een virtuele SCSI-adapter maken op een hardwareprofiel

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

Met de eerste opdracht wordt het hardwareprofielobject met de naam NewHWProfile01 opgehaald uit de VMM-bibliotheek en wordt het object opgeslagen in de $HWProfile variabele.

Met de tweede opdracht maakt u een virtuele SCSI-adapter op NewHWProfile01.

Parameters

-AdapterID

Hiermee geeft u het nummer van de logische eenheid of LUN-id. Hyper-V en XenServer stellen deze waarde niet beschikbaar en kunnen deze niet worden gewijzigd. Voor een VMware ESX-host is de standaardwaarde 7 en kan deze niet worden gewijzigd.

Type:Byte
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HardwareProfile

Hiermee geeft u een hardwareprofielobject.

Type:HardwareProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u de naam van een gebruiker. Met deze cmdlet stelt u de namens de gebruiker in als de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Met deze cmdlet stelt u de namens de gebruikersrol in als de gebruikersrol die door deze parameter wordt opgegeven. Als u een gebruikersrolobject wilt verkrijgen, gebruikt u de cmdlet Get-SCUserRole.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScsiControllerType

Hiermee geeft u een type SCSI-controller op. Geldige waarden zijn:

  • DefaultTypeNoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Geaccepteerde waarden:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ShareVirtualScsiAdapter

Geeft aan of een virtuele SCSI-adapter wordt gedeeld, zodat deze kan worden gebruikt in gastclustering.

  • Hyper-V host: Nee (voor gastclustering gebruikt u iSCSI-opslag)
  • XenServer-host: Nee (Xen-VM's hebben altijd precies één SCSI-adapter)

Opmerking: Bij het delen van een SCSI-controller op een virtuele machine op een ESX-host wordt in VMM het beleid voor SCSI-delen op VMware standaard ingesteld op 'fysiek'.

Type:Boolean
Aliassen:Shared
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Synthetic

Geeft aan dat een apparaat, zoals een virtuele netwerkadapter, op een virtuele machine die is geïmplementeerd op een Hyper-V host een synthetische apparaat met hoge prestaties is. Vereist een virtualisatiebewust gastbesturingssysteem op de virtuele machine.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMTemplate

Hiermee geeft u een VMM-sjabloonobject op dat wordt gebruikt om virtuele machines te maken.

Type:Template
Aliassen:Template
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualSCSIAdapter

Met deze cmdlet wordt een VirtualSCSIAdapter--object geretourneerd.

Notities

  • Hiervoor is een VMM-object, sjabloonobject voor virtuele machines of hardwareprofielobjecten vereist, dat kan worden opgehaald met behulp van de Get-SCVirtualMachine, Get-SCVMTemplateof Get-SCHardwareProfile cmdlets.