New-PveAccessUsers

Create new user.

API: POST /access/users, Proxmox VE API viewer

Syntax

New-PveAccessUsers
    [-PveTicket <PveTicket>]
    [-Comment <string>]
    [-Email <string>]
    [-Enable <bool>]
    [-Expire <int>]
    [-Firstname <string>]
    [-Groups <string>]
    [-Keys <string>]
    [-Lastname <string>]
    [-Password <SecureString>]
    -Userid <string>
    [<CommonParameters>]

Parameters

Parameter	Type	Required	Description
-PveTicket	PveTicket	No
-Comment	string	No
-Email	string	No
-Enable	bool	No
-Expire	int	No
-Firstname	string	No
-Groups	string	No
-Keys	string	No
-Lastname	string	No
-Password	SecureString	No
-Userid	string	Yes

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.