OpticalDiskDrives.adoc

DSC Resource 'OpticalDiskDrives'

OpticalDiskDrives manages the drive letter assignment for optical disk drives (CD-ROM, DVD).

When to use 'OpticalDiskDrives'

Use this resource when you need to change or remove the drive letter of an optical disk drive. This is commonly done on servers to free up a specific drive letter (e.g., D:) for data disk use, or to standardize drive letter assignments across servers.

Source	https://github.com/dsccommunity/CommonTasks/tree/main/source/DSCResources/OpticalDiskDrives
DSC Resource	StorageDSC
Documentation	OpticalDiskDriveLetter

Table 1. Attributes of category 'OpticalDiskDrives'

Parameter	Attribute	DataType	Description	Allowed Values
Drives	Mandatory	Hashtable[]	List of optical disk drives

Table 2. Attributes of category 'OpticalDiskDrives/Drives'

Parameter	Attribute	DataType	Description	Allowed Values
DiskId	Key	String	Specifies the optical disk number for the disk to assign the drive letter to.
DriveLetter	Required	String	Specifies the drive letter to assign to the optical disk. Can be a single letter, optionally followed by a colon. This value is ignored if Ensure is set to Absent.
Ensure		String	Determines whether a drive letter should be assigned to the optical disk.	Present (default) Absent

Example

OpticalDiskDrives:
  Drives:
    - DiskId: 1
      DriveLetter: F
      Ensure: Present
    - DiskId: 2
      Ensure: Absent
    - DiskId: 3
      DriveLetter: G

See also

• MountImages