Add AcmaSchemaAttribute

Add-AcmaSchemaAttribute

Description

Creates a new attribute in the ACMA database schema

Syntax

Add-AcmaSchemaAttribute -Name <string> -Type <AcmaPSAttributeType> [-IsMultivalued <bool>] [-IsIndexed <bool>] [-Operation <AcmaAttributeOperation>]

Parameters

-Name

The name of the attribute

Type: String
Required: Yes
Position: 0

-Type

The data type of the attribute

Type: AcmaPSAttributeType
Required: Yes
Position: 1

Valid values:

Type	Description
Binary	A binary value up to 800 bytes in length
BinaryNotIndexable	A binary value over 800 bytes in length
Boolean	A Boolean value
DateTime	A date and time value
Integer	A 64-bit integer value
Reference	A reference-type value
String	A string value up to 400 characters in length
StringNotIndexable	A string value over 400 characters in length

-IsMultivalued

Indicates if the attribute contains multiple values

Type: Boolean
Required: No
Position: 2
Default: $false

Note: Not valid for Boolean values

-IsIndexed

Indicates if the attribute values are indexed

Type: Boolean
Required: No
Position: 3
Default: $false

Note: Boolean and non-indexable types cannot be indexed

-Operation

Defines the types of operations allowed on this attribute

Type: AcmaAttributeOperation
Required: No
Position: 4
Default: ImportExport

Valid values:

Operation	Description
AcmaInternal	The attribute is not visible to MIM
AcmaInternalTemp	The attribute is not visible to MIM, and its value is never saved to the database
ExportOnly	The attribute is visible to MIM, but can only be exported (write-only)
ImportExport	The attribute is visible to MIM, and can be imported and exported
ImportOnly	The attribute is visible to MIM, but can only be imported (read-only)

Return type

This cmdlet does not return any output

Examples

Example 1: Create a basic string attribute

Add-AcmaSchemaAttribute -Name "accountName" -Type String -IsMultivalued $false -IsIndexed $true -Operation ImportExport

Example 2: Create a boolean attribute

Add-AcmaSchemaAttribute -Name "accountDisabled" -Type Boolean -IsMultivalued $false -Operation ImportExport

Example 3: Create a multivalued reference attribute

Add-AcmaSchemaAttribute -Name "groups" -Type Reference -IsMultivalued $true -IsIndexed $true -Operation ImportExport

Example 4: Create an internal-only attribute

Add-AcmaSchemaAttribute -Name "internalCalculation" -Type Integer -Operation AcmaInternal

Notes

• Boolean attributes cannot be multivalued or indexed