A PowerShell module that helps you get un-stuck from dependency version conflicts that often occur when trying to connect to multiple Microsoft services.
Numerous PowerShell modules include a dependency on the Microsoft Authentication Library (MSAL) for authenticating to Microsoft's online services. The latest version of the MSAL is actively maintained in AzureAD/microsoft-authentication-library-for-dotnet. However, modules that depend on the MSAL libraries (such as Microsoft.Identity.Client.dll) all update their releases with different versions of MSAL on different schedules. This results in version conflicts that break authentication flows whenever you try to use multiple modules in one session. Examples of modules that can be affected by this include:
- Az.Accounts
- ExchangeOnlineManagement
- Microsoft.Graph.Authentication
- MicrosoftTeams
- MSAL.PS
- Maester
...and many more.
You can manually attempt to work around this by checking which version of the conflicting DLLs are used by each of your PowerShell modules and then connect first to whichever service module uses the newest version of the DLL.
This works because of the "first one wins" rule and because the MSAL is designed to be backwards compatible.
DLL Pickle handles this for you by automatically releasing a new version of DLL Pickle whenever a new release of the MSAL is found. As long as you keep the DLL Pickle module up to date and load it first in your PowerShell profile (or manually load it first in your session), then all other PowerShell modules should be able to use this new MSAL that is loaded by DLL Pickle.
Any of the following PowerShell editions:
- PowerShell on Linux, macOS, or Windows
- Windows PowerShell 5.1
Install-PSResource -Name DLLPickle -PrereleaseThe easiest way to benefit from DLL Pickle is to import the module in your PowerShell profile before any other module or assembly is loaded. Just add the line Import-Module DLLPickle to your profile, save it, and start a new instance of PowerShell.
Alternatively, if you are starting work in a new PowerShell session in which you know you will be authenticating to multiple online services, you can run Import-Module DLLPickle at the beginning of your session and then proceed with the rest of your modules.
This project follows the semantic versioning model. It also packages numerous dependencies that follow their own versioning. To maintain clarity, this project will follow SemVer standards and the following logic for version changes:
🏷️ 2.x.x.x - The major version will only change if there is a breaking change in the DLL Pickle project.
🏷️ X.1.X.X - The minor version will change if any of the following occur:
- New features are added to the project
- New tracked assemblies are added to the project
🏷️ X.X.1.X - The build version will change if any of the following occur:
- Minor refactoring for performance, error handling, or logging
- A new version of any packaged assembly is automatically updated within the project
🏷️ X.X.X.1234 - The revision segment of the version may change if any of the following occur:
- Minor fixes for typos or formatting
- Changes to documentation