Skip to content

Rename AcmaSchemaAttribute

Ryan Newington edited this page Sep 4, 2025 · 5 revisions

Rename-AcmaSchemaAttribute

Description

Renames an attribute in the ACMA database schema

Syntax

Rename-AcmaSchemaAttribute -CurrentName <string> -NewName <string>

Parameters

-CurrentName

The current name of the attribute

Type: String
Required: Yes
Position: 0

-NewName

The new name of the attribute

Type: String
Required: Yes
Position: 1

Return type

This cmdlet does not return any output

Examples

Example 1: Rename an attribute

Rename-AcmaSchemaAttribute -CurrentName "accountName" -NewName "samAccountName"

Important Warnings

⚠️ WARNING: Renaming an attribute in the database will NOT rename it in any configuration files, which may render the configuration file unable to be opened.

Recommended Approach:

  1. Open the configuration file in the ACMA editor
  2. Rename the attribute using the UI
  3. Save the configuration file

The ACMA editor will automatically update all references to the attribute in the ACMAX file with the new name when you save.

Clone this wiki locally