Skip to content

New-PveNodesQemuConfig

SYNOPSIS

SYNTAX

New-PveNodesQemuConfig [[-PveTicket] <PveTicket>] [[-Acpi] <Boolean>] [[-Affinity] <String>]
 [[-Agent] <String>] [[-AllowKsm] <Boolean>] [[-AmdSev] <String>] [[-Arch] <String>] [[-Args_] <String>]
 [[-Audio0] <String>] [[-Autostart] <Boolean>] [[-BackgroundDelay] <Int32>] [[-Balloon] <Int32>]
 [[-Bios] <String>] [[-Boot] <String>] [[-Bootdisk] <String>] [[-Cdrom] <String>] [[-Cicustom] <String>]
 [[-Cipassword] <SecureString>] [[-Citype] <String>] [[-Ciupgrade] <Boolean>] [[-Ciuser] <String>]
 [[-Cores] <Int32>] [[-Cpu] <String>] [[-Cpulimit] <Single>] [[-Cpuunits] <Int32>] [[-Delete] <String>]
 [[-Description] <String>] [[-Digest] <String>] [[-Efidisk0] <String>] [[-Force] <Boolean>]
 [[-Freeze] <Boolean>] [[-Hookscript] <String>] [[-HostpciN] <Hashtable>] [[-Hotplug] <String>]
 [[-Hugepages] <String>] [[-IdeN] <Hashtable>] [[-ImportWorkingStorage] <String>] [[-IntelTdx] <String>]
 [[-IpconfigN] <Hashtable>] [[-Ivshmem] <String>] [[-Keephugepages] <Boolean>] [[-Keyboard] <String>]
 [[-Kvm] <Boolean>] [[-Localtime] <Boolean>] [[-Lock] <String>] [[-Machine] <String>] [[-Memory] <String>]
 [[-MigrateDowntime] <Single>] [[-MigrateSpeed] <Int32>] [[-Name] <String>] [[-Nameserver] <String>]
 [[-NetN] <Hashtable>] [-Node] <String> [[-Numa] <Boolean>] [[-NumaN] <Hashtable>] [[-Onboot] <Boolean>]
 [[-Ostype] <String>] [[-ParallelN] <Hashtable>] [[-Protection] <Boolean>] [[-Reboot] <Boolean>]
 [[-Revert] <String>] [[-Rng0] <String>] [[-SataN] <Hashtable>] [[-ScsiN] <Hashtable>] [[-Scsihw] <String>]
 [[-Searchdomain] <String>] [[-SerialN] <Hashtable>] [[-Shares] <Int32>] [[-Skiplock] <Boolean>]
 [[-Smbios1] <String>] [[-Smp] <Int32>] [[-Sockets] <Int32>] [[-SpiceEnhancements] <String>]
 [[-Sshkeys] <String>] [[-Startdate] <String>] [[-Startup] <String>] [[-Tablet] <Boolean>] [[-Tags] <String>]
 [[-Tdf] <Boolean>] [[-Template] <Boolean>] [[-Tpmstate0] <String>] [[-UnusedN] <Hashtable>]
 [[-UsbN] <Hashtable>] [[-Vcpus] <Int32>] [[-Vga] <String>] [[-VirtioN] <Hashtable>] [[-VirtiofsN] <Hashtable>]
 [[-Vmgenid] <String>] [-Vmid] <Int32> [[-Vmstatestorage] <String>] [[-Watchdog] <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Set virtual machine options (asynchronous API).

EXAMPLES

Example 1

PS C:\> {{ Add example code here }}

{{ Add example description here }}

PARAMETERS

-PveTicket

Ticket data connection.

Type: PveTicket
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Acpi

Enable/disable ACPI.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Affinity

List of host cores used to execute guest processes, for example':' 0,5,8-11

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Agent

Enable/disable communication with the QEMU Guest Agent and its properties.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-AllowKsm

Allow memory pages of this guest to be merged via KSM (Kernel Samepage Merging).

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-AmdSev

Secure Encrypted Virtualization (SEV) features by AMD CPUs

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Arch

Virtual processor architecture. Defaults to the host. Enum: x86_64,aarch64

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 7
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Args_

Arbitrary arguments passed to kvm.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 8
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Audio0

Configure a audio device, useful in combination with QXL/Spice.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 9
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Autostart

Automatic restart after crash (currently ignored).

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 10
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-BackgroundDelay

Time to wait for the task to finish. We return 'null' if the task finish within that time.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 11
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Balloon

Amount of target RAM for the VM in MiB. Using zero disables the ballon driver.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 12
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Bios

Select BIOS implementation. Enum: seabios,ovmf

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 13
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Boot

Specify guest boot order. Use the 'order=' sub-property as usage with no key or 'legacy=' is deprecated.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 14
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Bootdisk

Enable booting from specified disk. Deprecated':' Use 'boot':' order=foo;bar' instead.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 15
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cdrom

This is an alias for option -ide2

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 16
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cicustom

cloud-init':' Specify custom files to replace the automatically generated ones at start.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 17
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cipassword

cloud-init':' Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: False
Position: 18
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Citype

Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows. Enum: configdrive2,nocloud,opennebula

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 19
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Ciupgrade

cloud-init':' do an automatic package upgrade after the first boot.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 20
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Ciuser

cloud-init':' User name to change ssh keys and password for instead of the image's configured default user.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 21
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cores

The number of cores per socket.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 22
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cpu

Emulated CPU type.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 23
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cpulimit

Limit of CPU usage.

Type: Single
Parameter Sets: (All)
Aliases:

Required: False
Position: 24
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Cpuunits

CPU weight for a VM, will be clamped to \[1, 10000] in cgroup v2.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 25
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Delete

A list of settings you want to delete.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 26
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Description

Description for the VM. Shown in the web-interface VM's summary. This is saved as comment inside the configuration file.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 27
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Digest

Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 28
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Efidisk0

Configure a disk for storing EFI vars. Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Note that SIZE_IN_GiB is ignored here and that the default EFI vars are copied to the volume instead. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 29
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Force

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.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 30
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Freeze

Freeze CPU at startup (use 'c' monitor command to start execution).

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 31
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Hookscript

Script that will be executed during various steps in the vms lifetime.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 32
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-HostpciN

Map host PCI devices into guest.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 33
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Hotplug

Selectively enable hotplug features. This is a comma separated list of hotplug features':' 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 34
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Hugepages

Enables hugepages memory.Sets the size of hugepages in MiB. If the value is set to 'any' then 1 GiB hugepages will be used if possible, otherwise the size will fall back to 2 MiB. Enum: any,2,1024

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 35
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IdeN

Use volume as IDE hard disk or CD-ROM (n is 0 to 3). Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 36
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ImportWorkingStorage

A file-based storage with 'images' content-type enabled, which is used as an intermediary extraction storage during import. Defaults to the source storage.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 37
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IntelTdx

Trusted Domain Extension (TDX) features by Intel CPUs

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 38
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IpconfigN

cloud-init':' Specify IP addresses and gateways for the corresponding interface.IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicitgateway should be provided.For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. This requirescloud-init 19.4 or newer.If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to usingdhcp on IPv4.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 39
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Ivshmem

Inter-VM shared memory. Useful for direct communication between VMs, or to the host.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 40
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Keephugepages

Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 41
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Keyboard

Keyboard layout for VNC server. This option is generally not required and is often better handled from within the guest OS. Enum: de,de-ch,da,en-gb,en-us,es,fi,fr,fr-be,fr-ca,fr-ch,hu,is,it,ja,lt,mk,nl,no,pl,pt,pt-br,sv,sl,tr

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 42
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Kvm

Enable/disable KVM hardware virtualization.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 43
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Localtime

Set the real time clock (RTC) to local time. This is enabled by default if the `ostype` indicates a Microsoft Windows OS.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 44
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Lock

Lock/unlock the VM. Enum: backup,clone,create,migrate,rollback,snapshot,snapshot-delete,suspending,suspended

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 45
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Machine

Specify the QEMU machine.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 46
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Memory

Memory properties.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 47
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-MigrateDowntime

Set maximum tolerated downtime (in seconds) for migrations. Should the migration not be able to converge in the very end, because too much newly dirtied RAM needs to be transferred, the limit will be increased automatically step-by-step until migration can converge.

Type: Single
Parameter Sets: (All)
Aliases:

Required: False
Position: 48
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-MigrateSpeed

Set maximum speed (in MB/s) for migrations. Value 0 is no limit.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 49
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Name

Set a name for the VM. Only used on the configuration web interface.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 50
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Nameserver

cloud-init':' Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 51
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-NetN

Specify network devices.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 52
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Node

The cluster node name.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 53
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Numa

Enable/disable NUMA.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 54
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-NumaN

NUMA topology.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 55
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Onboot

Specifies whether a VM will be started during system bootup.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 56
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Ostype

Specify guest operating system. Enum: other,wxp,w2k,w2k3,w2k8,wvista,win7,win8,win10,win11,l24,l26,solaris

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 57
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ParallelN

Map host parallel devices (n is 0 to 2).

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 58
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Protection

Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 59
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Reboot

Allow reboot. If set to '0' the VM exit on reboot.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 60
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Revert

Revert a pending change.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 61
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Rng0

Configure a VirtIO-based Random Number Generator.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 62
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SataN

Use volume as SATA hard disk or CD-ROM (n is 0 to 5). Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 63
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ScsiN

Use volume as SCSI hard disk or CD-ROM (n is 0 to 30). Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 64
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Scsihw

SCSI controller model Enum: lsi,lsi53c810,virtio-scsi-pci,virtio-scsi-single,megasas,pvscsi

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 65
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Searchdomain

cloud-init':' Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 66
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SerialN

Create a serial device inside the VM (n is 0 to 3)

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 67
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Shares

Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 68
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Skiplock

Ignore locks - only root is allowed to use this option.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 69
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Smbios1

Specify SMBIOS type 1 fields.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 70
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Smp

The number of CPUs. Please use option -sockets instead.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 71
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Sockets

The number of CPU sockets.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 72
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SpiceEnhancements

Configure additional enhancements for SPICE.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 73
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Sshkeys

cloud-init':' Setup public SSH keys (one key per line, OpenSSH format).

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 74
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Startdate

Set the initial date of the real time clock. Valid format for date are':''now' or '2006-06-17T16':'01':'21' or '2006-06-17'.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 75
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Startup

Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 76
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Tablet

Enable/disable the USB tablet device.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 77
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Tags

Tags of the VM. This is only meta information.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 78
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Tdf

Enable/disable time drift fix.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 79
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Template

Enable/disable Template.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 80
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Tpmstate0

Configure a Disk for storing TPM state. The format is fixed to 'raw'. Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Note that SIZE_IN_GiB is ignored here and 4 MiB will be used instead. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 81
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-UnusedN

Reference to unused volumes. This is used internally, and should not be modified manually.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 82
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-UsbN

Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 83
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Vcpus

Number of hotplugged vcpus.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 84
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Vga

Configure the VGA hardware.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 85
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-VirtioN

Use volume as VIRTIO hard disk (n is 0 to 15). Use the special syntax STORAGE_ID':'SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID':'0 and the 'import-from' parameter to import from an existing volume.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 86
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-VirtiofsN

Configuration for sharing a directory between host and guest using Virtio-fs.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 87
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Vmgenid

Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 88
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Vmid

The (unique) ID of the VM.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: 89
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Vmstatestorage

Default storage for VM state volumes/files.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 90
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Watchdog

Create a virtual hardware watchdog device.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 91
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

PveResponse. Return response.

NOTES