Install Prerequisites

In order to connect UMRA to your Office 365 tenant, and begin managing users and groups, you will need to install/configure several prerequisites.

  1. Create an administrative service account inside of Office 365.  Make note of its username and password, as you will need it inside of UMRA.

  3. Install the Microsoft .NET 3.51 Framework (if not already included on your server)
  4. Install the UMRA Powershell Agent Service
  5. Install the Microsoft Online Services Plugins

    • Microsoft Online Services Sign-In Assistant
    • Windows Azure AD Module for Windows PowerShell

Verify Connectivity

Once the prerequisites are installed, we recommend verifying connectivity to Office 365.  This can be easily done through native PowerShell, without involving UMRA.

  1. Launch PowerShell
  2. Run the following script, supplying the administrative service account credentials when prompted:

$msolcred = get-credential
connect-msolservice -credential $msolcred

Create Your Script

Now that you can connect to Office 365's PowerShell interface, you can begin using UMRA to manage your users and groups in the cloud.

  1. Launch the UMRA Console from the Start Menu
  2. Create a new script
  3. In the Actions pane, expand the Powershell > Agent service session folder
  4. Drag a Setup PowerShell Agent service session action into your script pane
  5. Drag a Release PowerShell Agent service session action just underneath of it
  6. In the Actions pane, expand the Office 365 > General folder
  7. Drag a Office 365 Setup connect action into your script pane, between your Setup and Release Powershell actions

    • You will need to configure the Username and Password properties of this action
  9. Drag a Office 365 Release connection action just underneath of it
  10. Your script should now look like this:

Note that the values of the Office 365 Connection properties of the Office 365 actions, and the Session ID properties of the PowerShell actions do not match.  This must be rectified, as all actions that take place inside of a PowerShell session must connect to the same session variable.

  1. Select your Setup PowerShell Agent service session action, and double click on its Session ID property
  2. Change the output value variable from %PowershellAgentSessionId% to %G_Office365PowerShellSession%
  3. Do the same for the Release Powershell Agent service session action

Save and run your script, and troubleshoot any errors that are reported (e.g., access denied, bad credentials, etc.).  Once you can run your script with no errors, you are ready to add more actions, such as pulling data from an HR system, creating users, groups, etc.