Compartir a través de

New-SCVirtualScsiAdapter

  • Referencia
Módulo:
VirtualMachineManager

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.

Sintaxis

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, plantilla de máquina virtual o perfil de hardware usado 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 para 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 de 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.

Tipo:Byte
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HardwareProfile

Especifica un objeto de perfil de hardware.

Tipo:HardwareProfile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScsiControllerType

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

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Tipo:VMSCSIControllerType
Valores aceptados:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ShareVirtualScsiAdapter

Indica si se comparte un adaptador SCSI virtual para que se pueda usar en la agrupación en clústeres invitados.

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

Nota: Al compartir un controlador SCSI en una máquina virtual en un host ESX, VMM toma como valor predeterminado la directiva de uso compartido SCSI en VMware en "físico".

Tipo:Boolean
Alias:Shared
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 compatible con virtualización en la máquina virtual.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual.

Tipo:VM
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMTemplate

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

Tipo:Template
Alias:Template
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 el uso de los cmdlets get-SCVirtualMachine, Get-SCVMTemplateo cmdlets Get-SCHardwareProfile, respectivamente.