Parallels Desktop Developer's Guide
ProductsSupportDocumentation
  • Introduction
    • Parallels Desktop in Software Development
    • Optimizing Your Virtual Machine for Software Development
    • Download Pre-Configured Virtual Machines
  • Software Development-specific Functions of Parallels Desktop
    • Optimizing Remote Debugging
    • Generating a Core Dump
    • Using VM Names as DNS Names
    • Starting a Debugging Session
    • Establishing a Serial Connection over TCP
    • Using Rosetta to Run x86-64 Linux Software on Apple Silicon Macs
    • Resolving Guest OS DNS Requests Using etc/hosts
    • Changing the Virtual Screen Resolution on the Fly
    • Nested Virtualization Support
    • Simulating Adverse Network Connectivity Conditions
  • DevOps Service
  • AI Development with Parallels Desktop
    • Installing a Dedicated AI Development Virtual Machine
    • Using the Parallels AI Virtual Machine for Development
  • Integrations and Plugins
    • Integration with Chef/Ohai
    • Integration with Packer
    • Visual Studio Code Extension
    • Integration with Terraform
    • Integration with Vagrant
  • Command-Line Interface Utility
    • Manage Parallels Desktop from CLI
      • Display Parallels Desktop Information
      • License Management
        • Sign into Parallels Account
        • Install a Parallels Desktop License
        • Install/Remove a Deferred License
        • Update a License
        • Deactivate a License
      • Parallels Desktop Preferences
      • User List and Virtual Machine Location
      • Virtual Network Information and Settings
      • USB Devices
      • Report a Problem
      • Shut Down Parallels Desktop
      • Error Handling
    • Manage Virtual Machines from CLI
      • General Virtual Machine Management
        • List Virtual Machines
        • Create a Virtual Machine
        • Delete a Virtual Machine
        • Register/Unregister a Virtual Machine
        • Clone a Virtual Machine
        • Convert a Virtual Machine
        • Move Virtual Machine Files
        • Install Parallels Tools
        • Log into a Virtual Machine
        • Execute a Command in a Virtual Machine
        • Send a Keyboard Event to a Virtual Machine
          • List of Parallels Keyboard Key Codes
        • Query the Virtual Machine Status
        • Power Operations
        • Capture a Screen Area
        • Encrypt/Decrypt a Virtual Machine
        • Archive/Unarchive a Virtual Machine
        • Set Password Protection
      • Virtual Machine Configuration Tasks
        • CPU and Memory Parameters
        • Boot Order Parameters
        • Video Parameters
        • Mouse & Keyboard Parameters
        • Virtual Printer Parameters
        • USB & Bluetooth Parameters
        • Startup & Shutdown Parameters
        • Optimization Parameters
        • Sharing Parameters
        • Coherence Parameters
        • Security Parameters
        • Expiration Date Parameters
        • Device Management
          • Common Options
          • Adding/Modifying a Device
          • Virtual Hard Drive
          • Physical Hard Drive
          • Virtual Optical Drive
          • Physical Optical Drive
          • Virtual Floppy Drive
          • Physical Floppy Drive
          • Virtual Network Adapter
          • Virtual Serial Port
          • Virtual Parallel Port
          • Virtual Sound Card
          • Adding USB Support
        • Shared Folders
        • Advanced Settings
        • Miscellaneous
      • Snapshot Management
        • Taking a Virtual Machine Snapshot
        • Deleting a Snapshot
        • Listing Snapshots
        • Reverting to a Snapshot
      • Miscellaneous
        • Generating a Problem Report
        • Using Guest Debugger
        • Creating a VM Dump
      • Virtual Machine Disk Optimization
      • Error Handling
  • Parallels Open Source Initiatives
Powered by GitBook

Other Resources

  • Community Forum
  • Knowledge Base
  • Request Support

Social Media

  • Facebook
  • Twitter/X
  • YouTube
  • LinkedIn

© 2025 Parallels International GmbH. All rights reserved.

On this page
  • Adding an Optical Drive
  • Modifying an Optical Drive
  1. Command-Line Interface Utility
  2. Manage Virtual Machines from CLI
  3. Virtual Machine Configuration Tasks
  4. Device Management

Virtual Optical Drive

Adding an Optical Drive

Note: Adding virtual optical drives is not supported in macOS virtual machines.

--device-add cdrom [--image <name>] [--iface <ide | scsi | sata>] [--position <n>]

[--subtype <buslogic | lsi-spi | lsi-sas>]

Modifying an Optical Drive

--device-set <drive_name> [--image <name>] [--iface <ide | scsi | sata>]

[--position <n>] [--subtype <buslogic | lsi-spi | lsi-sas>]

Parameters

drive_name: The name of the optical drive to modify (--device-set command only). To obtain the list of the available drives, use the prlctl list --info command.

--image: connect the specified image file to the virtual machine. The following image file formats are supported: iso, cue, ccd, dmg.

--iface: virtual optical interface type: ide, scsi, sata.

--position: the SCSI / IDE / SATA device identifier to be used for the optical drive. Allowed ranges:

  • 0-3 for IDE disk drives

  • 0-6 for SCSI disk drives

  • 0-5 for SATA disk drives

--subtype: virtual optical drive subtype: buslogic, lsi-spi, lsi-sas.

PreviousPhysical Hard DriveNextPhysical Optical Drive

Last updated 1 year ago