Azure AD Exporter

The Azure AD Exporter is a PowerShell module that allows you to export your Azure AD / Identity related objects and settings. You can run this as a nightly scheduled task or a DevOps component (Azure DevOps, GitHub, Jenkins) and commit the exported files to an internal GIT repository. This way you can have a complete version history of your tenant settings.

Development Environment Setup

Use the following command to Test the Program on your development environment

    Import-Module .\AzureADExporter.psd1

Installing the module

    Install-Module AzureADExporter

Using the module

Connecting to your tenant

    Connect-AADExporter

Exporting objects and settings

To export object and settings use the following command:

    Invoke-AADExporter -Path 'C:\AzureADBackup\'

This will export the most common set of object and settings.

The following object and settings are not exported by default:

• B2C
• B2B
• Static Groups and group memberships
• Applications
• ServicePrincipals
• Users
• Priviledge Identity Management (built in roles, default roles settings, non permanent role assignement)

To export all the objects and settings supported (no filter applied):

    Invoke-AADExporter -Path 'C:\AzureADBackup\' -All

To Select specific object and settings to export the -Type parameter can be used. The default type is "Config":

    # export default all users as well as default objects and settings
    Invoke-AADExporter -Path 'C:\AzureADBackup\' -Type "Config","Users"
    # export applications only
    Invoke-AADExporter -Path 'C:\AzureADBackup\' -Type "Applications"
     # export B2C specific properties only
    Invoke-AADExporter -Path 'C:\AzureADBackup\' -Type "B2C"
    # export B2B properties along with AD properties
    Invoke-AADExporter -Path 'C:\AzureADBackup\' -Type "B2B","Config"

A filter can be applied to only export user and groups that are not synced from onprem (cloud users and groups):

    Invoke-AADExporter -Path 'C:\AzureADBackup\' -CloudUsersOrGroupsOnly

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.