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.