Add AcmaConstant

Add-AcmaConstant

Description

Creates a new constant in the ACMA database. Constants are global configuration values that can be referenced in rules, constructors, and declarative expressions throughout the ACMA system.

Syntax

Add-AcmaConstant -Name <string> -Value <object>

Parameters

Name (String)

The unique name for the new constant

• Required: Yes
• Position: Named
• Pipeline input: No
• Accepts: String (must be unique within the database)

Value (Object)

The initial value to assign to the constant

• Required: Yes
• Position: Named
• Pipeline input: No
• Accepts: String, Integer, Boolean, or other supported types

Return Type

This cmdlet does not return any objects

Examples

Create a mail domain constant

Add-AcmaConstant -Name "mailSuffix" -Value "@acma.com"

Create organizational unit constants

Add-AcmaConstant -Name "userOU" -Value "OU=Users,DC=acma,DC=com"
Add-AcmaConstant -Name "groupOU" -Value "OU=Groups,DC=acma,DC=com"

Create numeric constants

Add-AcmaConstant -Name "maxPasswordAge" -Value 90
Add-AcmaConstant -Name "defaultQuotaMB" -Value 1024

Notes

• Constant names must be unique within the ACMA database
• Once created, constants can be referenced in business rules using the syntax %constantName%
• Constants are commonly used for domain names, organizational units, default values, and other global configuration settings
• Use descriptive names to make business rules more readable and maintainable
• Consider grouping related constants with consistent naming conventions (e.g., "mail_", "ou_", "default_")