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 a Hard Drive
  • Modify a Hard Drive
  1. Command-Line Interface Utility
  2. Manage Virtual Machines from CLI
  3. Virtual Machine Configuration Tasks
  4. Device Management

Virtual Hard Drive

Adding a Hard Drive

--device-add hdd [--image <image_name>] [--type <expand | plain>] [--size <n>] [--split]

[--iface <ide | scsi | sata>] [--position <n>]

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

[--online-compact <on | off>]

Modify a Hard Drive

--device-set <hdd_name> [--image <image_name>] [--type <expand | plain>]

[--size <n>] [--split] [--iface <ide | scsi | sata>] [--position <n>]

[--subtype <buslogic | lsi-spi | lsi-sas>] [--online-compact <on | off>]

Parameters

hdd_name: The name of the virtual hard drive to modify (--device-set command only). Virtual hard drives are named using the hddN format, where N is the drive index number starting from 0 (e.g., hdd0, hdd1). To obtain the list of disk names, use the prlctl list --info command.

--image: specifies the name of the file to be used for emulating the VM virtual disk drive. If this option is omitted, a new file is created inside the directory storing all VM-related configuration files and assigned the name of harddiskN.hdd.

--type: specifies the type of the virtual disk from one of the following:

  • expand (default): virtual disks of this type are small initially and grow in size as you add data to it.

  • plain: virtual disks of this type have a fixed size from the moment of their creation.

--size: hard disk size, in megabytes.

--split: splits the hard disk into 2GB pieces.

--iface: virtual hard disk interface type: ide, scsi, or sata.

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

  • 0-3 for IDE disk drives

  • 0-6 for SCSI disk drives

  • 0-5 for SATA disk drives

--subtype: virtual hard disk subtype: buslogic, lsi-spi, lsi-sas.

--online-compact: enables or disables virtual hard disk online compact mode.

PreviousAdding/Modifying a DeviceNextPhysical Hard Drive

Last updated 1 year ago