The Domino Effect: ‘extensible-connector-refresh-required’

Symptoms: MIM Domino MA run operations return the error message ‘extensible-connector-refresh-required’

Cause: Updating the Domino MA requires the COM interface on it to be refreshed

Resolution: Open the Domino MA in the MIM Sync MMC and press OK, the MA will start refreshing the COM interface (and the user will need to press OK 4 more times as the MA cycles through different sections for updates).

Lesson: The Domino MA doesn’t have a ‘Refresh Interface’ button like a standard normal ECMA2 would, if you open the MA configuration and press OK rather than Cancel it detects the refresh requirements and initiates a refresh.



Parsing JSON files with PowerShell on Azure VM’s using ConvertFrom-JSON

The Outdated Newtonsoft.JsonDLL Conspiracy

The Outdated Newtonsoft.Json.DLL Conspiracy

From our special agent Json Bourne: notes from the field.

Make sure you are reading a raw string: i.e. (Get-Content JsonFile.JSON -raw) | ConvertFrom-Json

PowerShell seems to use an outdated Newtonsoft.Json.DLL file which doesn’t fully support comments

Make sure there are no comments in the .JSON file – if there are any you may need to manually edit them out to get ConvertFrom-Json to behave

The two versions being used on Azure VM’s seem to be (October/2013) and (February/2014).

Support for comments in JSON files in Newtonsoft.Json.DLL was first added in version 5.03 from 2014/11 (support for single line comments) and expanded on in later versions (6.07+)

The latest version of Newtonsoft.Json.DLL is 10.0.2 (as of April/2017)


Newtonsoft.JSON on Github

If you put a comment into a Json file and try to run ConvertFrom-JSON in PowerShell on it you will get the following error message:

ConvertFrom-Json : Invalid object passed in, ‘:’ or ‘}’ expected. (1): {
At line:1 char:28
+ Get-Content .\config.JSON |ConvertFrom-Json -Verbose
+                            ~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : NotSpecified: (:) [ConvertFrom-Json], ArgumentException
+ FullyQualifiedErrorId : System.ArgumentException,Microsoft.PowerShell.Commands.ConvertFromJsonCommand


An Introduction to JavaScript Object Notation (JSON) in JavaScript and .NET (February 2007)