Main replace to my Exch-Relaxation Powershell Module for accessing Workplace365 and Alternate 2016 Mailboxes through REST For a couple of yr I’ve being engaged on a PowerShell Module for accessing the brand new REST API for Workplace365 (the Graph API) and Alternate 2016. I have been experimenting and listening to the assorted suggestions I have been getting and eventually have an replace to share that addresses lots of the useability points (okay it was simply too developer oriented).
Nonetheless most likely the largest stumbling block just isn’t having an utility registration, I now have a menu that enables to you employ varied default registrations for testing and likewise to save lots of a default registration that you just create. This implies upon getting your personal registration setup it can save you the ClientId so it is going to be used because the default whenever you subsequent use the module.
A failure in correct planning once I initially created the module meant I did not use a selected alias for the cmdlets within the module which meant it may possibly trigger lots of conflicts when you have different modules loaded. With the brand new model all cmldets have a -EXR moniker.
With earlier variations of the module you mainly would authenticate and create an entry token and retailer that in a neighborhood variable which you then needed to cross into every of the cmdlets utilizing the -AccessToken parameter together with the MailboxName. This meant lots of typing and actually broke the useability stream with out actually offering any safety advantages. With the brand new module whereas all these previous behaviours are nonetheless legitimate there’s now a Join-EXRMailbox cmdlet which is the brand new entry level cmdlet which is able to retailer the token and the title of the mailbox related to the Token in a script variable (encrypted in fact) however accessible by the module. This implies you’ll be able to run many of the cmdlets with out specifying a Mailbox or Entry Token should you simply need to return particulars in regards to the present mailbox that has been authenticated. Additionally in relation to utilizing Listing or Reporting cmdlets it eliminates the necessity for MailboxName which used obligatory parameter on all cmdlets.
New Getting Began Information
With the sort of challenge documentation is the toughest factor as its the least fascinating and extra time consuming issues to get right. I’ve written a brand new getting Began Information for those that have not used the module earlier than. The previous readme information remains to be legitimate so in case your trying to make use of App Tokens this going to be helpful
I’ve lots of new cmldets most aren’t documented in anyway however I hope to place these extra into Context within the new yr on the weblog and on GitHub. Issues like accessing the Reporting API’s is fascinating which I’ve coated briefly within the new Getting Began information.
The brand new module Exch-Relaxation is offered from the PowerShell Gallery right here
or the supply code which is able to accommodates all the most recent code is offered on GitHub right here
Suggestions and Contributions
As all the time I welcome any suggestions or contributors who need to enhance the module