Compartir a través de

New-SCVirtualDVDDrive

  • Referencia
Módulo:
VirtualMachineManager

Crea una unidad de DVD virtual en una máquina virtual, una plantilla de máquina virtual o un perfil de hardware usado en VMM.

Sintaxis

New-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -JobGroup <Guid>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -HardwareProfile <HardwareProfile>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VM <VM>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VMTemplate <Template>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet New-SCVirtualDVDDrive crea un objeto de unidad de DVD virtual en una máquina virtual, una plantilla de máquina virtual o un perfil de hardware usado en un entorno de Virtual Machine Manager (VMM). De forma predeterminada, la unidad de DVD virtual creada por New-SCVirtualDVDDrive no está conectada a ningún medio. Puede usar el cmdlet set-SCVirtualDVDDrive de para conectar una unidad de DVD virtual a una unidad de DVD física en un host de máquina virtual o a una imagen ISO.

Nota: Puede conectar una unidad de DVD virtual a un dispositivo IDE en una máquina virtual, pero no puede conectar una unidad de DVD virtual a un adaptador SCSI en una máquina virtual.

Ejemplos

Ejemplo 1: Creación de una unidad de DVD virtual en una máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1

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

El segundo comando crea una unidad de DVD virtual en VM01 y conecta la unidad de DVD virtual al canal secundario (1) especificando IDE Bus 1 y LUN 1.

Ejemplo 2: Creación de una unidad de DVD virtual en una plantilla de máquina virtual

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

El primer comando obtiene el objeto templat de máquina virtual denominado VMTemplate01 y almacena el objeto en la variable $Template.

El segundo comando crea una unidad de DVD virtual en VMTemplate01 que conecta una unidad de DVD virtual al canal secundario (1) en el bus IDE cuando se usa la plantilla para crear una máquina virtual.

Ejemplo 3: Crear una unidad de DVD virtual en un perfil de hardware

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

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

El segundo comando crea una unidad de DVD virtual en HardwareProfile1 que conecta una unidad de DVD virtual al canal secundario (1) en el bus IDE cuando se usa el perfil de hardware para crear una máquina virtual.

Ejemplo 4: Creación de una máquina virtual con una unidad de DVD virtual que se conecta a cualquier unidad de DVD física disponible en el host

PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualDVDDrive -VMMServer "VMMServer01.Contoso.com" -JobGroup $JobGroupId -Bus 1 -LUN 0 -AnyVMHostDrive 
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> New-SCVirtualMachine -Name "VM04" -Description "A new VM with a DVD drive" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -StartVM -JobGroup $JobGroupId

El primer comando crea una nueva cadena GUID y la almacena en la variable $JobGroupID. Este GUID es un identificador de grupo de trabajos que funciona como identificador que agrupa los comandos posteriores que incluyen este identificador en un único grupo de trabajos.

El segundo comando crea un nuevo objeto de unidad de DVD virtual y especifica que esta nueva unidad de DVD virtual puede usar cualquier unidad de DVD física disponible. El comando conectará la nueva unidad de DVD virtual a la primera ranura del segundo canal IDE (IDE es el único tipo de bus al que se puede conectar una unidad de DVD virtual). El uso del identificador de grupo de trabajos especifica que este comando no se ejecuta hasta justo antes del comando final que incluye el parámetro JobGroup se ejecuta.

El tercer comando obtiene el objeto host denominado VMHost04 y almacena el objeto en la variable $VMHost.

El último comando crea una máquina virtual, la denomina VM04, proporciona una descripción, asigna un propietario y especifica la ubicación en el host para almacenar la máquina virtual. El comando usa el identificador del grupo de trabajos para ejecutar el comando New-SCVirtualDVDDrive justo antes de que se ejecute el comando New-SCVirtualMachine; el objeto de unidad de DVD virtual resultante está asociado a la nueva máquina virtual.

Ejemplo 5: Agregar una nueva unidad de DVD virtual a una máquina virtual existente y adjuntar un archivo ISO desde la biblioteca a la unidad

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $ISO = Get-SCISO | where {$_.Name -eq "WindowsServer2008R2.iso"}
PS C:\> New-SCVirtualDVDDrive -VM $VM -ISO $ISO -Bus 1 -LUN 1

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

El segundo comando obtiene el objeto ISO denominado WindowsServer2008R2.iso y almacena el objeto en la variable $ISO.

El último comando crea una nueva unidad de DVD virtual en VM05, la asocia a la ubicación especificada en el bus IDE y la vincula con la imagen ISO almacenada en $ISO.

Parámetros

-AnyVMHostDrive

Indica que un DVD virtual o una unidad de disquete de una máquina virtual se conectarán a cualquier unidad física correspondiente en un host. Esta asignación se produce cuando se implementa una máquina virtual almacenada en un host o cuando se usa una plantilla o un perfil de hardware para crear e implementar una máquina virtual en un host.

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

-Bus

Especifica el bus IDE al que se va a conectar una unidad de disco virtual o una unidad de DVD virtual, o el bus SCSI al que se va a conectar una unidad de disco virtual.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
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

-ISO

Especifica un objeto ISO.

Tipo:ISO
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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

-Link

Indica que un recurso debe estar vinculado a en lugar de copiarse.

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

-LUN

Especifica el número de unidad lógica (LUN) para un objeto de unidad de disco virtual o para un objeto de unidad de DVD virtual en un bus IDE o para un objeto de unidad de disco virtual en un bus SCSI.

  • Formato de ejemplo: -IDE -Bus 1 -LUN 0
  • Formato de ejemplo: -SCSI -Bus 0 -LUN 1
Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del 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. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

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

-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

-VMHostDrive

Especifica una unidad en un host de máquina virtual.

Formatos de ejemplo:

  • Hyper-V disco duro host: "C:"
  • unidad de disquete de host Hyper-V: "A:"
  • Disco duro host de VMware ESX: "/dev/tools"
  • Unidad de disquete de host de VMware ESX: "/dev/sda"
  • Unidad de disco duro host de Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Unidad de disquete de host de Citrix XenServer: no compatible
Tipo:String
Alias:HostDrive
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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

VirtualDVDDrive

Este cmdlet devuelve un objeto VirtualDVDDrive.

Notas

  • Requiere un objeto de máquina virtual VMM, un objeto de plantilla de máquina virtual o un objeto de perfil de hardware. Puede recuperar estos objetos mediante el Get-SCVirtualMachine, get-SCVMTemplateo cmdlets get-SCHardwareProfile, respectivamente.