Launch workplace control panel from hyperlink

Scenario

You want to send a simple email to your Windows Phone 8.1 users to enrol their devices in the Windows Intune service, without telling them how to go to settings and find the workplace control panel.

You want a simple hyperlink in the email that redirects the end users to the workplace control panel for Windows Phone 8.1.

 

Theory

The Windows Phone 8.1 MDM Protocol guide is a mecca for information around the current capabilities for the Windows Phone platform.

As part of this documentation there are some powerful and handy tips.

One of these tips is around launching the workplace control panel from a hyperlink. In the documentation is describes that Windows Phone 8.1 supports the launching of the workplace control panel using a hyperlink: mssettings-workplace.

This should read : mssettings-workplace:

Please note the : at the end.

image

This sounds really promising to help end users join the workplace for Windows Intune. This means you can send an email to a user with the above hyperlink which intern open the workplace control panel.

 

However when receiving emails from an Exchange server, Windows Phone automatically filters out links like ms-settings-workplace: .  If you copy/paste the link, you will see that it has been replaced.

So the end users end up seeing the below

image

 

Solution

To work around this, the system does support HREF tags for HTML.  In order for this to work, you must host a re-direct website or page that can redirect the user to ms-settings-workplace: via a website to avoid the remapping on the client.  This will invoke the IE browser to deep-link into the settings page.

For example here is some source for a HTML page that you can copy and paste into notepad or web editor;

 

<!DOCTYPE HTML>
<html lang=”en-US”>
<head>
<meta charset=”UTF-8″>
<meta http-equiv=”refresh” content=”0;url=”ms-settings-workplace://”>
<script type=”text/javascript”>
window.location.href = “ms-settings-workplace://”
</script>
<title>Page Redirection</title>
</head>
<body>
<!– Note: don’t tell people to `click` the link, just tell them that it is a link. –>
If you are not redirected automatically, follow the <a href=’ms-settings-workplace://’>link to example</a>
</body>
</html>

 

Save this html to a file called wp811.htm . You can then upload or host it on your production website for your organisation.

As this point I can then send a email out to my end users. With a hyperlink that redirects clients to your WP811.htm location in an email that can be picked up on there Windows Phone 8.1 devices.

As an example here is my link that will kick off the workplace control panel :

http://www.theenterprisemobilityguy.com/wp-content/uploads/2014/08/wp811.htm

As example here is the whole workflow

image

I have highlighted some pages that your end user will never see, as an example the redirect page will not show.

References :

Windows Phone 8.1 MDM protocol documentation : http://msdn.microsoft.com/en-us/library/dn499787.aspx

Windows Phone 8.1 MDM protocol documentation PDF : Windows Phone 8.1 MDM protocol documentation

Leave a Reply

Your email address will not be published. Required fields are marked *