< Back

New-vRAPropertyGroup

Sat Jan 18, 2020 10:02 pm

NAME New-vRAPropertyGroup



SYNOPSIS

Create a custom Property Group





SYNTAX

New-vRAPropertyGroup -Name <String> [-Label <String>] [-Description <String>] [-Tenant <String>] [-WhatIf]

[-Confirm] [<CommonParameters>]



New-vRAPropertyGroup [-Label <String>] [-Description <String>] [-Tenant <String>] -Properties <Hashtable>

[-WhatIf] [-Confirm] [<CommonParameters>]



New-vRAPropertyGroup [-Label <String>] [-Description <String>] [-Tenant <String>] -JSON <String> [-WhatIf]

[-Confirm] [<CommonParameters>]





DESCRIPTION

Create a custom Property Group





PARAMETERS

-Name <String>

The unique name (ID) of the Property



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Label <String>

The text to display in forms for the Property



Required? false

Position? named

Default value $Name

Accept pipeline input? false

Accept wildcard characters? false



-Description <String>

Description of the Property



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Tenant <String>

The tenant in which to create the Property Group (Defaults to the connection tenant )



Required? false

Position? named

Default value $Global:vRAConnection.Tenant

Accept pipeline input? false

Accept wildcard characters? false



-Properties <Hashtable>

A hashtable representing the properties you would like to build into this new property group



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-JSON <String>

Property Group to send in JSON format



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String.





OUTPUTS

System.Management.Automation.PSObject





-------------------------- EXAMPLE 1 --------------------------



PS C:\\># Create a simple property group with no properties addded



New-vRAPropertyGroup -Name one









-------------------------- EXAMPLE 2 --------------------------



PS C:\\># Create a property group with a description and label



New-vRAPropertyGroup -Name OneWithDescription -Label "On With Description" -Description "This is one with a label

and description"









-------------------------- EXAMPLE 3 --------------------------



PS C:\\># Create a property group with some properties added in simple form



New-vRAPropertyGroup -Name OneWithPropetiesSimple -Label "One With Properties" -Properties

@{"com.org.bool"=$false; "com.org.string"="string1"}









-------------------------- EXAMPLE 4 --------------------------



PS C:\\># Create a property group with some properties added in the extended form



New-vRAPropertyGroup -Name OneWithPropertiesExt -Label "One With Properties" -Properties

@{"com.org.bool"=@{"mandatory"=$true; "defaultValue"=$false;};

"com.org.encryptedandshowonform"=@{"encrypted"=$true; "visibility"=$true; "defaultValue"="Un-encrypted string";};}











RELATED LINKS