Set-SCVirtualDVDDrive
Cambia las propiedades de una unidad de DVD virtual asociada a una máquina virtual, plantilla de máquina virtual o perfil de hardware que se usa en VMM.
Syntax
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, plantilla de máquina virtual o 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 bien puede usarla para desconectar la unidad de DVD virtual.
La mayoría de las opciones 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 física de CD o DVD en el host sin especificar una letra de unidad.
Capturar información de un archivo de imagen (ISO) almacenado en la biblioteca VMM.
Captura de "ningún medio" (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:
Host de Hyper-V. 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 con un archivo ISO de la biblioteca VMM, no podrá usar el archivo directamente desde la biblioteca, sino que tendrá que aceptar la configuración predeterminada, que copia el archivo ISO en el host.
Host de Citrix XenServer. Si configura una conexión con un archivo ISO de la biblioteca VMM, no podrá usar el archivo directamente desde la biblioteca, sino que tendrá que aceptar la configuración predeterminada, 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 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: ). Además, elimina cualquier archivo ISO que usaba la unidad DVD anteriormente si ninguna otra máquina virtual usa actualmente dicho 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. Además, elimina cualquier archivo ISO que usaba la unidad DVD anteriormente si ninguna otra máquina virtual usa actualmente dicho 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 de 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.
Type: | SwitchParameter |
Aliases: | AnyHostDrive |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Bus
Especifica el bus IDE al que se conecta una unidad de disco virtual o una unidad de DVD virtual, o bien, el bus SCSI al que se conecta una unidad de disco virtual.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ISO
Especifica un objeto ISO.
Type: | ISO |
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 |
-Link
Indica que un recurso debe vincularse a en lugar de copiarse.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoMedia
Desconecta una unidad de DVD virtual de la unidad de host o el archivo ISO a los que estaba conectada o desconecta una unidad de disquete virtual de la unidad de host o disquete virtual a los que estaba conectada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del 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. 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.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (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 inmediatamente al shell de comandos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceBus
Especifica el bus ide de origen para la unidad.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualDVDDrive
Especifica un objeto de unidad de DVD virtual.
Type: | VirtualDVDDrive |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMHostDrive
Especifica una unidad en un host de máquina virtual.
Formatos de ejemplo:
- Disco duro del host de Hyper-V:
"C:"
- Unidad de disquete del host de 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
Type: | String |
Aliases: | HostDrive |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .