Skip to content

New-PveClusterMappingPci

Create a new hardware mapping.

API: POST /cluster/mapping/pci, Proxmox VE API viewer

New-PveClusterMappingPci
[-PveTicket <PveTicket>]
[-Description <string>]
-Id <string>
[-LiveMigrationCapable <bool>]
-Map <array>
[-Mdev <bool>]
[<CommonParameters>]
Parameter Type Required Description
-PveTicket PveTicket No Ticket data connection.
-Description string No Description of the logical PCI device.
-Id string Yes The ID of the logical PCI mapping.
-LiveMigrationCapable bool No Marks the device(s) as being able to be live-migrated (Experimental). This needs hardware and driver support to work.
-Map array Yes A list of maps for the cluster nodes.
-Mdev bool No Marks the device(s) as being capable of providing mediated devices.

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.

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