Active-Directory-Alias-Mana.../README.md
2024-08-04 20:48:29 +02:00

2.8 KiB

Active Directory Alias Management Script

This PowerShell script allows you to manage user aliases in Active Directory and perform a delta sync with Azure Active Directory. The script provides a simple user interface to add aliases to users and perform synchronization.

Features

  • Add alias to a user's proxyAddresses attribute in Active Directory.
  • Perform a delta sync with Azure Active Directory.
  • User-friendly interface with clear instructions and feedback.

Prerequisites

  • Windows PowerShell
  • Active Directory module for Windows PowerShell
  • Azure Active Directory Connect installed and configured

Usage

  1. Clone or download the script:

  2. Run the script:

    .\AliasManagement.ps1
    
  3. Follow the prompts:

    • The script will provide options to either add an alias to a user or exit and perform a delta sync.
    • When adding an alias, you will be prompted to enter the User Principal Name (UPN) and the alias.
    • After adding an alias, the script will update the user in Active Directory and provide feedback.
    • On exiting, the script will perform a delta sync and wait for it to complete before closing.

Script Walkthrough

Add Alias

  • Prompts for User Principal Name (UPN) and alias.
  • Checks if the user exists in Active Directory.
  • Checks if the alias is already present in the user's proxyAddresses attribute.
  • Adds the alias if it is not already present.
  • Updates the user object in Active Directory.
  • Provides feedback on success or failure.

Delta Sync

  • Runs Azure Active Directory synchronization.
  • Waits for the synchronization to complete.
  • Provides feedback when the synchronization is complete.

Example

  1. Starting the script:

    ===== Active Directory Alias Management =====
    Choose an option:
    1. Add alias
    2. Exit
    Enter your choice (1 or 2):
    
  2. Adding an alias:

    ===== Add Alias to User =====
    Enter the User Principal Name (UPN) of the user (e.g., user@example.com): user@example.com
    Enter the alias to be added (e.g., alias@example.com): alias@example.com
    Alias 'alias@example.com' added successfully to the user's proxyAddresses attribute.
    Press Enter to continue...
    
  3. Exiting and performing delta sync:

    ===== Delta Sync =====
    Waiting for synchronization to finish...
    Azure Active Directory synchronization completed successfully.
    Press Enter to continue...
    

Notes

  • Ensure you have the necessary permissions to update user objects in Active Directory and perform synchronization.

License

This script is provided under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss changes.