Troubleshooting

Troubleshooting assembly conflicts¶

DLLPickle includes an issue reproduction test harness for collecting repeatable diagnostics when Microsoft service modules load conflicting assemblies. The default tests use synthetic modules and do not require service credentials, VS Code, Azure Automation, or PSGallery module installation.

Run the safe issue repro tests¶

The safe repro task prepares the built module output and runs integration tests while excluding tests tagged LiveRepro.

Invoke-Build -Task IssueReproTest -File .\build\DLLPickle.Build.ps1

The tests write Pester output under artifacts\testOutput. Individual scenario tests also return structured JSON in temporary paths while they run.

Run live repro tests¶

Live repro tests are skipped unless the DLLPICKLE_RUN_LIVE_REPRO environment variable is set to 1.

$env:DLLPICKLE_RUN_LIVE_REPRO = '1'
Invoke-Build -Task IssueReproTest -File .\build\DLLPickle.Build.ps1
Remove-Item Env:\DLLPICKLE_RUN_LIVE_REPRO -ErrorAction SilentlyContinue

Live tests may import installed copies of modules such as ExchangeOnlineManagement, Microsoft.Graph.Authentication, Az.Storage, and PowerShellEditorServices.Commands. They are intended for maintainer-controlled diagnostics because they depend on the local host, installed module versions, and optional service authentication.

Run a VS Code host repro¶

Use the VS Code task named IssueReproTest-Live from the integrated PowerShell terminal to compare VS Code host behavior with a regular terminal session.

Compare two scenario results¶

When evaluating a fix, capture a baseline JSON result and a candidate JSON result, then compare them with:

. .\tests\Integration\Compare-DLLPickleScenarioResult.ps1
Compare-DLLPickleScenarioResult -BaselinePath .\before.json -CandidatePath .\after.json

The comparison shows changed step outcomes and final loaded assembly differences by name, version, and location.

Current issue-specific findings¶

Issue #156: Graph Authentication and ExchangeOnlineManagement¶

DLLPickle packages exact Azure.Core and MSAL managed-family pins for the supported base profile. The issue repro tests assert that the protected import path maintains the expected Azure.Core preload line to avoid GetTokenAsync type identity failures.

For sessions that need Exchange Online, Microsoft Teams, Microsoft Graph, and Az.Accounts imported together, use:

Import-Module DLLPickle
Import-DPBaseProfile

This imports the validated base profile order:

ExchangeOnlineManagement
MicrosoftTeams
Microsoft.Graph.Authentication
Az.Accounts

Az.Accounts can still fail if it is imported before Microsoft Graph because it may load older Azure identity assemblies first. The same order is recommended for consistency.

There is a remaining Az authentication limitation even with the validated import order: Connect-AzAccount can fail after Graph or Exchange loads Azure.Identity because Az.Accounts uses a module-local assembly loader. Run Az authentication and Az cmdlets in a separate process from Graph/Exchange workloads when this occurs.

Issue #174: Az.Storage and ExchangeOnlineManagement OData¶

Az.Storage 9.6.0 imports Microsoft.OData.Core 7.6.4. ExchangeOnlineManagement 3.9.2 can later request Microsoft.OData.Core 7.22.0 from Get-EXO* cmdlets. Preloading OData 7.22.0 from DLLPickle was tested and rejected because it breaks Az.Storage import with an assembly collision against its 7.6.4 copy.

The safe repro tests keep this scenario visible but do not treat OData preloading as a supported fix. If both modules need incompatible OData versions, run the Az.Storage and ExchangeOnlineManagement work in separate PowerShell processes so each process has its own assembly load context.