Condividi tramite

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 altri adattatori.

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.

Tipo:Byte
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-HardwareProfile

Specifica un oggetto profilo hardware.

Tipo:HardwareProfile
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnBehalfOfUser

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:UserRole
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScsiControllerType

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

  • DefaultTypeNoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Tipo:VMSCSIControllerType
Valori accettati:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, VMM per impostazione predefinita il criterio di condivisione SCSI in VMware viene impostato su "fisico".

Tipo:Boolean
Alias:Shared
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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. Richiede un sistema operativo guest compatibile con la virtualizzazione nella macchina virtuale.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VM

Specifica un oggetto macchina virtuale.

Tipo:VM
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMTemplate

Specifica un oggetto modello VMM usato per creare macchine virtuali.

Tipo:Template
Alias:Template
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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-SCVMTemplateo Get-SCHardwareProfile.