Share via

New-SCVirtualScsiAdapter

  • Riferimento
Modulo:
VirtualMachineManager

Crea una scheda SCSI virtuale in una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato in VMM.

Sintassi

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

Descrizione

Il cmdlet New-SCVirtualScsiAdapter crea una scheda SCSI virtuale in una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato in un ambiente VMM (Virtual Machine Manager). Dopo aver creato la scheda SCSI virtuale, è possibile usare il cmdlet Set-SCVirtualScsiAdapter per modificarne le impostazioni.

Nota: l'uso del parametro ShareVirtualScsiAdapter per condividere una scheda SCSI virtuale in una macchina virtuale per abilitare il clustering guest è supportato solo se la macchina virtuale viene distribuita in un host ESX. Il parametro SharedVirtualScsiAdapter non viene usato per una macchina virtuale in un host Hyper-V perché una macchina virtuale in un host Hyper-V usa iSCSI per l'archiviazione condivisa.

Una macchina virtuale in un host Citrix XenServer ha sempre una scheda SCSI virtuale. Non è possibile rimuovere l'adattatore o aggiungere adattatori aggiuntivi.

Esempio

Esempio 1: Creare una scheda SCSI virtuale in una macchina virtuale

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.

Il secondo comando crea una scheda SCSI virtuale in VM01.

Esempio 2: Creare una scheda SCSI virtuale in un modello di macchina virtuale

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

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato VMTemplate01 dalla libreria VMM e archivia l'oggetto nella variabile $VMTemplate.

Il secondo comando crea una scheda SCSI virtuale in VMTemplate01.

Esempio 3: Creare una scheda SCSI virtuale in un profilo hardware

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

Il primo comando ottiene l'oggetto profilo hardware denominato NewHWProfile01 dalla libreria VMM e archivia l'oggetto nella variabile $HWProfile.

Il secondo comando crea una scheda SCSI virtuale in NewHWProfile01.

Parametri

-AdapterID

Specifica il numero di unità logica o l'ID LUN. Hyper-V e XenServer non espongono questo valore e non possono essere modificati. Per un host VMware ESX, il valore predefinito è 7 e non può essere modificato.

Type:Byte
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HardwareProfile

Specifica un oggetto profilo hardware.

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

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-OnBehalfOfUser

Specifica il nome di un utente. Questo cmdlet imposta l'oggetto per conto dell'utente come utente specificato da questo parametro.

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

-OnBehalfOfUserRole

Specifica un ruolo utente. Questo cmdlet imposta l'oggetto per conto del ruolo utente come ruolo utente specificato da questo parametro. Per ottenere un oggetto ruolo utente, usare il cmdlet Get-SCUserRole .

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-ScsiControllerType

Specifica un tipo di controller SCSI. I valori validi sono:

  • 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

Indica se una scheda SCSI virtuale è condivisa in modo che possa essere usata nel clustering guest.

  • Host Hyper-V: No (per il clustering guest, usare l'archiviazione iSCSI)
  • Host XenServer: No (le macchine virtuali Xen hanno sempre esattamente una scheda SCSI)

Nota: quando si condivide un controller SCSI in una macchina virtuale in un host ESX, il criterio di condivisione SCSI in VMware viene configurato per impostazione predefinita su "physical".

Type:Boolean
Aliases:Shared
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Synthetic

Indica che un dispositivo, ad esempio una scheda di rete virtuale, in una macchina virtuale distribuita in un host Hyper-V è un dispositivo sintetico ad alte prestazioni. Nella macchina virtuale deve essere installato un sistema operativo guest che supporti la virtualizzazione.

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

-VM

Specifica un oggetto macchina virtuale.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

-VMTemplate

Specifica un oggetto modello VMM utilizzato per creare macchine virtuali.

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

Output

VirtualSCSIAdapter

Questo cmdlet restituisce un oggetto VirtualSCSIAdapter .

Note

  • Richiede un oggetto macchina virtuale VMM, un oggetto modello di macchina virtuale o un oggetto profilo hardware, che può essere recuperato usando rispettivamente i cmdlet Get-SCVirtualMachine, Get-SCVMTemplate o Get-SCHardwareProfile .