System command

attach-vdisk command

Attaches (sometimes called mounts or surfaces) a virtual hard disk (VHD) so that it appears on the host computer as a local hard disk drive. This guide lists the documented syntax and parameters for attach-vdisk; check Microsoft Learn for version, role and execution-context requirements.

Availability: Microsoft Learn command reference spanning Windows client and Windows Server releases; some entries are legacy, role-specific, optional-feature or interactive subcommands.中文

Documented syntax

attach vdisk [readonly] { [sd=<SDDL>] | [usefilesd] } [noerr]

The linked Microsoft Learn article is the upstream authority. Availability may depend on Windows release, role, optional feature or interactive tool context.

Examples

Example from the linked Microsoft Learn article. Check its paths, targets and availability before adapting it.

attach vdisk readonly

Parameters, options and clauses

Option / clause	Description
`readonly`	Attach the selected virtual disk read-only; writes fail.
`sd=<SDDL>`	Set an access filter using a Security Descriptor Definition Language string.
`usefilesd`	Use the security descriptor stored on the .vhd file.
`noerr`	Continue DiskPart script processing after an error; intended for scripts.

Safety note

Review a command and its target before running it. Commands that alter files, services, accounts, disks, permissions or databases may be difficult to reverse. Test in a safe environment and keep backups.

Official reference ↗Back to directory