New-SCVirtualScsiAdapter

Crea un adaptador SCSI virtual en una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usa en VMM.

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

Description

El cmdlet New-SCVirtualScsiAdapter crea un adaptador SCSI virtual en una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usa en un entorno de Virtual Machine Manager (VMM). Después de crear el adaptador SCSI virtual, puede usar el cmdlet Set-SCVirtualScsiAdapter para modificar su configuración.

Nota: El uso del parámetro ShareVirtualScsiAdapter para compartir un adaptador SCSI virtual en una máquina virtual con el fin de habilitar la agrupación en clústeres invitados solo se admite si la máquina virtual se implementa en un host ESX. El parámetro SharedVirtualScsiAdapter no se usa para una máquina virtual en un host de Hyper-V porque una máquina virtual de un host de Hyper-V usa iSCSI para el almacenamiento compartido.

Una máquina virtual en un host citrix XenServer siempre tiene un adaptador SCSI virtual. No puede quitar este adaptador ni agregar adaptadores adicionales.

Ejemplos

Ejemplo 1: Creación de un adaptador SCSI virtual en una máquina virtual

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

El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.

El segundo comando crea un adaptador SCSI virtual en VM01.

Ejemplo 2: Creación de un adaptador SCSI virtual en una plantilla de máquina virtual

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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado VMTemplate01 de la biblioteca VMM y almacena el objeto en la variable $VMTemplate.

El segundo comando crea un adaptador SCSI virtual en VMTemplate01.

Ejemplo 3: Creación de un adaptador SCSI virtual en un perfil de hardware

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

El primer comando obtiene el objeto de perfil de hardware denominado NewHWProfile01 de la biblioteca VMM y almacena el objeto en la variable $HWProfile.

El segundo comando crea un adaptador SCSI virtual en NewHWProfile01.

Parámetros

-AdapterID

Especifica el número de unidad lógica o el identificador de LUN. Hyper-V y XenServer no exponen este valor y no se pueden cambiar. Para un host de VMware ESX, el valor predeterminado es 7 y no se puede cambiar.

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

-HardwareProfile

Especifica un objeto de perfil de hardware.

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-OnBehalfOfUser

Especifica el nombre de un usuario. Este cmdlet establece en nombre del usuario como usuario que especifica este parámetro.

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

-OnBehalfOfUserRole

Especifica un rol de usuario. Este cmdlet establece en nombre del rol de usuario como rol de usuario que especifica este parámetro. Para obtener un objeto de rol de usuario, use el cmdlet Get-SCUserRole .

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

-PROTipID

Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

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

-ScsiControllerType

Especifica un tipo de controlador SCSI. Los valores válidos son:

  • 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 si se comparte un adaptador SCSI virtual para que se pueda usar en la agrupación en clústeres invitados.

  • Host de Hyper-V: no (para la agrupación en clústeres invitados, use el almacenamiento iSCSI)
  • Host de XenServer: No (las máquinas virtuales Xen siempre tienen exactamente un adaptador SCSI)

Nota: al compartir un controlador SCSI de una máquina virtual en un host ESX, VMM establece en "física" de forma predeterminada la política de uso compartido de SCSI en VMware.

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

-Synthetic

Indica que un dispositivo, como un adaptador de red virtual, en una máquina virtual implementada en un host de Hyper-V es un dispositivo sintético de alto rendimiento. Requiere un sistema operativo invitado preparado para virtualización en la máquina virtual.

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

-VM

Especifica un objeto de máquina virtual.

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

-VMMServer

Especifica un objeto de servidor VMM.

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

-VMTemplate

Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.

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

Salidas

VirtualSCSIAdapter

Este cmdlet devuelve un objeto VirtualSCSIAdapter .

Notas

  • Requiere un objeto de máquina virtual VMM, un objeto de plantilla de máquina virtual o un objeto de perfil de hardware, que se puede recuperar mediante los cmdlets Get-SCVirtualMachine, Get-SCVMTemplate o Get-SCHardwareProfile , respectivamente.