Set-PveNodesQemuUnlink

Unlink/delete disk images.

API: PUT /nodes/{node}/qemu/{vmid}/unlink, Proxmox VE API viewer

Syntax

Set-PveNodesQemuUnlink
    [-PveTicket <PveTicket>]
    [-Force <bool>]
    -Idlist <string>
    -Node <string>
    -Vmid <int>
    [<CommonParameters>]

Parameters

Parameter	Type	Required	Description
-PveTicket	PveTicket	No	Ticket data connection.
-Force	bool	No	Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called ‘unused[n]’, which contains the volume ID. Unlink of unused[n] always cause physical removal.
-Idlist	string	Yes	A list of disk IDs you want to delete.
-Node	string	Yes	The cluster node name.
-Vmid	int	Yes	The (unique) ID of the VM.

Every parameter also binds by property name from the pipeline, so an object with node and vmid properties (the output of Get-PveGuest, for one) fills -Node and -Vmid. Without -PveTicket the cmdlet uses the last connection, see Connection.

Output

A PveResponse: the data returned by Proxmox VE is in .Response.data, the outcome in .IsSuccessStatusCode. See Results and Errors.