A.99 edit VmDiskMapping

Edits the virtual machine disk mapping object.

Syntax

edit VmDiskMapping instance [ virtualCd=instance ] [ name=value ] [ description=value ]

Where instance is:

{ id=value | name=value }

Description

This command edits the virtual machine disk mapping object. Do not use this command to change the disk mapping in a virtual machine, this is just for the object that contains the disk mapping information. To edit a virtual disk or CDROM mapped to a virtual machine, remove it using the delete VmDiskMapping command, then use the create VmDiskMapping command again to remap it to a virtual machine with any changed settings.

Although none of the options are mandatory, you must supply at least one option.

Options

The following table shows the available options for this command.

Option

Description

virtualCd=instance

The name or ID of the ISO file (virtual CDROM).

name=value

A name to identify the disk mapping.

Tip

To find this name after a virtual disk is mapped to a virtual machine, use the list VmDiskMapping command.

description=value

Optional description for the disk mapping object. value is a maximum of 4,000 characters.

To set an empty description, use description="".

{ id=value | name=value }

The instance of the object using either the id or name option, for example name=MyDiskMap.

Examples

Example A.124 Editing a virtual disk mapping object

OVM> edit VmDiskMapping id=0004fb0000130000409cd9340443e257 name=MyDiskMap

See Also