Set-PveClusterQemuCustomCpuModels

Update a custom CPU model definition.

API: PUT /cluster/qemu/custom-cpu-models/{cputype}, Proxmox VE API viewer

Syntax

Set-PveClusterQemuCustomCpuModels
    [-PveTicket <PveTicket>]
    -Cputype <string>
    [-Delete <string>]
    [-Digest <string>]
    [-Flags <string>]
    [-GuestPhysBits <int>]
    [-Hidden <bool>]
    [-HvVendorId <string>]
    [-Level <long>]
    [-PhysBits <string>]
    [-ReportedModel <string>]
    [<CommonParameters>]

Parameters

Parameter	Type	Required	Description
-PveTicket	PveTicket	No	Ticket data connection.
-Cputype	string	Yes	Name for the custom CPU model. The ‘custom-’ prefix is optional.
-Delete	string	No	A list of properties to delete.
-Digest	string	No	Prevent changes if current configuration file has a different digest. This can be used to prevent concurrent modifications.
-Flags	string	No	List of additional CPU flags separated by ‘;’. Use ‘+FLAG’ to enable, ‘-FLAG’ to disable a flag. There is a special ‘nested-virt’ shorthand which controls nested virtualization for the current CPU (‘svm’ for AMD and ‘vmx’ for Intel). Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons: aes, amd-no-ssb, amd-ssbd, hv-evmcs, hv-tlbflush, ibpb, md-clear, nested-virt, pcid, pdpe1gb, spec-ctrl, ssbd, virt-ssbd.
-GuestPhysBits	int	No	Number of physical address bits available to the guest.
-Hidden	bool	No	Do not identify as a KVM virtual machine. Only affects vCPUs with x86-64 architecture.
-HvVendorId	string	No	The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.
-Level	long	No	Maximum input value for the basic CPUID leaves the guest can query - that is the vendor (leaf 0), family/model/stepping and feature bits (leaf 1), cache and topology info (leaves 4 and B), and so on. Higher-numbered leaves are hidden. Setting ‘30’ is a common workaround for Hyper-V boot failures on Windows guests running on recent Intel hosts. Only applies when the vCPU architecture is x86_64.
-PhysBits	string	No	The physical memory address bits that are reported to the guest OS. Should be smaller or equal to the host’s. Set to ‘host’ to use value from host CPU, but note that doing so will break live migration to CPUs with other values.
-ReportedModel	string	No	CPU model and vendor to report to the guest. Must be a QEMU/KVM supported model. Only valid for custom CPU model definitions, default models will always report themselves to the guest OS. Values: 486, a64fx, athlon, Broadwell, Broadwell-IBRS, Broadwell-noTSX, Broadwell-noTSX-IBRS, Cascadelake-Server, Cascadelake-Server-noTSX, Cascadelake-Server-v2, Cascadelake-Server-v4, Cascadelake-Server-v5, ClearwaterForest, ClearwaterForest-v2, ClearwaterForest-v3, Conroe, Cooperlake, Cooperlake-v2, core2duo, coreduo, cortex-a35, cortex-a53, cortex-a55, cortex-a57, cortex-a710, cortex-a72, cortex-a76, cortex-a78ae, DiamondRapids, EPYC, EPYC-Genoa, EPYC-Genoa-v2, EPYC-IBPB, EPYC-Milan, EPYC-Milan-v2, EPYC-Milan-v3, EPYC-Rome, EPYC-Rome-v2, EPYC-Rome-v3, EPYC-Rome-v4, EPYC-Rome-v5, EPYC-Turin, EPYC-v3, EPYC-v4, EPYC-v5, GraniteRapids, GraniteRapids-v2, GraniteRapids-v3, GraniteRapids-v4, GraniteRapids-v5, Haswell, Haswell-IBRS, Haswell-noTSX, Haswell-noTSX-IBRS, host, Icelake-Client, Icelake-Client-noTSX, Icelake-Server, Icelake-Server-noTSX, Icelake-Server-v3, Icelake-Server-v4, Icelake-Server-v5, Icelake-Server-v6, Icelake-Server-v7, IvyBridge, IvyBridge-IBRS, KnightsMill, kvm32, kvm64, max, Nehalem, Nehalem-IBRS, neoverse-n1, neoverse-n2, neoverse-v1, Opteron_G1, Opteron_G2, Opteron_G3, Opteron_G4, Opteron_G5, Penryn, pentium, pentium2, pentium3, phenom, qemu32, qemu64, SandyBridge, SandyBridge-IBRS, SapphireRapids, SapphireRapids-v2, SapphireRapids-v3, SapphireRapids-v4, SapphireRapids-v5, SapphireRapids-v6, SierraForest, SierraForest-v2, SierraForest-v3, SierraForest-v4, SierraForest-v5, Skylake-Client, Skylake-Client-IBRS, Skylake-Client-noTSX-IBRS, Skylake-Client-v4, Skylake-Server, Skylake-Server-IBRS, Skylake-Server-noTSX-IBRS, Skylake-Server-v4, Skylake-Server-v5, Westmere, Westmere-IBRS.

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.