Set-SCVirtualDVDDrive
Cambia las propiedades de una unidad de DVD virtual asociada a una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usa en VMM.
Sintaxis
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-NoMedia]
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
-VMHostDrive <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-NoMedia]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-JobGroup <Guid>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-Link]
-ISO <ISO>
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-VMHostDrive <String>
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-Link]
[-VirtualDVDDrive] <VirtualDVDDrive>
-ISO <ISO>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-JobGroup <Guid>
[-AnyVMHostDrive]
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
El cmdlet Set-SCVirtualDVDDrive cambia una o varias propiedades de un objeto de unidad de DVD virtual asociado a una máquina virtual, una plantilla de máquina virtual o un perfil de hardware usado en un entorno de Virtual Machine Manager (VMM).
Puede usar este cmdlet para conectar una unidad de DVD virtual a una unidad de DVD física en un servidor host de máquina virtual, a una ubicación diferente en el bus IDE o a una imagen ISO, o puede usarla para desconectar la unidad de DVD virtual.
La mayoría de las opciones de configuración que puede configurar para una unidad de DVD virtual en una máquina virtual son las mismas independientemente de si la plataforma de virtualización del host es Hyper-V, VMware o Citrix XenServer. Todas estas plataformas de virtualización admiten lo siguiente:
Conexión de una unidad de DVD virtual a un canal principal o secundario en un host.
Capturar información de una unidad de CD o DVD física en el host sin especificar una letra de unidad.
Capturar información de un archivo de imagen (ISO) almacenado en la biblioteca VMM.
Capturar "sin medios" (se usa para desconectar una unidad de DVD virtual de la unidad host o de un archivo ISO).
La única configuración que varía para este cmdlet por plataforma de virtualización es si se puede usar un archivo ISO directamente desde la biblioteca VMM:
Hyper-V host. Si configura una conexión a un archivo ISO en la biblioteca VMM, puede optar por usar la iso directamente desde la biblioteca en lugar de copiarla en el host.
Host de VMware ESX. Si configura una conexión a un archivo ISO en la biblioteca VMM, no puede usar la ISO directamente desde la biblioteca, sino que debe aceptar el valor predeterminado, que copia el archivo ISO en el host.
Host de Citrix XenServer. Si configura una conexión a un archivo ISO en la biblioteca VMM, no puede usar la ISO directamente desde la biblioteca, sino que debe aceptar el valor predeterminado, que copia el archivo ISO en el host. El host debe tener al menos un repositorio ISO disponible con acceso de escritura y espacio de almacenamiento suficiente para contener el archivo ISO.
Nota: Si la unidad de DVD virtual está configurada en una máquina virtual que se creó mediante el Asistente para máquinas virtuales en la consola del administrador de Hyper-V en lugar de en la consola VMM, debe especificar una letra de unidad. Esa letra de unidad aparecerá en las propiedades de esa máquina virtual en la consola de VMM.
Ejemplos
Ejemplo 1: Conexión de una unidad de DVD virtual a una unidad de DVD física
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -VMHostDrive "E:"
El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de unidad de DVD virtual que se encuentra en el canal secundario 0 (especificado por -Bus 1 y -LUN 0) en el bus ide de VM01 y almacena el objeto en la variable $DVDDrive.
El último comando conecta el objeto de unidad de DVD virtual almacenado en $DVDDrive a una unidad física del host (la unidad D: ). También elimina cualquier archivo ISO que la unidad de DVD virtual usó anteriormente si ninguna otra máquina virtual usa actualmente ese archivo ISO.
Ejemplo 2: Conexión de una unidad de DVD virtual a una ubicación diferente en el bus IDE
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -Bus 1 -LUN 1
El comando obtiene el objeto de máquina virtual denominado VM02 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de unidad de DVD virtual que se encuentra en el canal secundario 0 (especificado por -Bus 1 y -LUN 0) en el bus IDE de VM02 y, a continuación, almacena el objeto de unidad de DVD virtual en $DVDDrive.
El último comando conecta el objeto de unidad de DVD virtual almacenado en $DVDDrive a una posición diferente en el bus IDE estableciendo el número de unidad lógica (LUN) en 1.
Ejemplo 3: Desconectar una unidad de DVD virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -NoMedia
El primer comando obtiene el objeto de máquina virtual denominado VM03 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de unidad de DVD virtual que se encuentra en el canal secundario 0 (especificado por -Bus 1 y -LUN 0) en el bus IDE de VM03 y, a continuación, almacena el objeto de unidad de DVD virtual en $DVDDrive.
El último comando usa el parámetro NoMedia para desconectar el objeto de unidad de DVD virtual almacenado en $DVDDrive de cualquier unidad host o ISO a la que esté conectado. También elimina cualquier archivo ISO que la unidad de DVD virtual usó anteriormente si ninguna otra máquina virtual usa actualmente ese archivo ISO.
Ejemplo 4: Conexión de una unidad de DVD virtual en una máquina virtual existente a cualquier unidad de DVD física disponible
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})
El primer comando obtiene el objeto de máquina virtual denominado VM04 y almacena el objeto en la variable $VM.
El último comando obtiene el objeto de unidad de DVD virtual que se encuentra en la primera ranura del canal secundario (especificado por -Bus 1 y -LUN 0) en el bus IDE de VM04. El comando usa el cmdlet Set-SCVirtualDVDDrive con el parámetro AnyVMHostDrive para conectar la unidad de DVD virtual a cualquier unidad de DVD física disponible en el host.
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: | True |
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: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ISO
Especifica un objeto ISO.
Tipo: | ISO |
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 |
-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: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NoMedia
Desconecta una unidad de DVD virtual de la unidad host o ISO a la que estaba conectado, o desconecta una unidad de disquete virtual de la unidad host o el disco de disquete virtual al que estaba conectado.
Tipo: | SwitchParameter |
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
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 |
-SourceBus
Especifica el bus IDE de origen para la unidad.
Tipo: | Byte |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SourceLUN
Especifica el número de unidad lógica de origen (LUN) para un objeto de unidad de DVD virtual en un bus IDE.
Tipo: | Byte |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VirtualDVDDrive
Especifica un objeto de unidad de DVD virtual.
Tipo: | VirtualDVDDrive |
Posición: | 0 |
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: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Salidas
VirtualDVDDrive
Este cmdlet devuelve un objeto VirtualDVDDrive.
Notas
- Requiere un objeto de unidad de DVD virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualDVDDrive
.