New-PveClusterFirewallGroups

Create new security group.

API: POST /cluster/firewall/groups, Proxmox VE API viewer

Syntax

New-PveClusterFirewallGroups
    [-PveTicket <PveTicket>]
    [-Comment <string>]
    [-Digest <string>]
    -Group <string>
    [-Rename <string>]
    [<CommonParameters>]

Parameters

Parameter	Type	Required	Description
-PveTicket	PveTicket	No	Ticket data connection.
-Comment	string	No
-Digest	string	No	Prevent changes if current configuration file has a different digest. This can be used to prevent concurrent modifications.
-Group	string	Yes	Security Group name.
-Rename	string	No	Rename/update an existing security group. You can set ‘rename’ to the same value as ‘name’ to update the ‘comment’ of an existing group.

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.