How to deploy custom URL shortcuts with Microsoft Intune

by Nicky De Westelinck09/03/202105/10/2022

This article will describe how to deploy custom URL shortcuts with Microsoft Intune.

05/10/2022 UPDATE: added some adjustments to the script and also added the possibility to add a custom icon.

Welcome to my first post in my “Cases from the Field” series. This series will describe things I’ve done during the projects I’ve worked on as a Modern Workplace Consultant.

Let me briefly describe what our customer requested. They use 2 web applications and want them as a URL shortcut on their Windows 10/11 enrolled device. Instead of doing this manually for all their devices, they asked if it is possible to do this with Microsoft Intune.

To make this possible I’ve deployed a Powershell script with Microsoft Intune. The script (updated version with custom icon) is very simple:

#Variables creating local folder and download .ico file
$LocalIconFolderPath = "C:\URLIcon"
$SourceIcon = "http://nickydewestelinck.be/wp-content/icons/salesforce.ico"
$DestinationIcon = "C:\URLIcon\salesforce.ico"


#Step 1 - Create a folder to place the URL icon
New-Item $LocalIconFolderPath -Type Directory

#Step 2 - Download a ICO file from a website into previous created folder
curl $SourceIcon -o $DestinationIcon

#Step 3 - Add the custom URL shortcut to your Desktop with custom icon
$new_object = New-Object -ComObject WScript.Shell
$destination = $new_object.SpecialFolders.Item('AllUsersDesktop')
$source_path = Join-Path -Path $destination -ChildPath '\\Salesforce.lnk'
$source = $new_object.CreateShortcut($source_path)
$source.TargetPath = 'https://login.salesforce.com'
$source.IconLocation = ”C:\URLIcon\salesforce.ico”
$source.Save()

This Powershell script creates a custom URL shortcut with custom icon and places it in the Public Desktop folder of your Windows 10/11 device. In this case, it will place a URL shortcut “Salesforce” and this will go to https://login.salesforce.com/

How to deploy custom URL shortcut with Microsoft Intune

Now let me show you how to deploy this Powershell Script with Microsoft Intune.

Step 1: Create a Powershell Script (Updated)

This part of the article is an updated version. I’ve added a three extra steps, the first one or some variables we need to download and add an icon into a newly created folder locally. Be sure that your icon file is a .ico extension, I use X-Icon Editor (xiconeditor.com) to create/convert my image into a, .ico file and then upload them to my site. You can also use Azure blob storage to store your icon files.

For example, these are the variables:

#Variables creating local folder and download .ico file
$LocalIconFolderPath = "C:\URLIcon"
$SourceIcon = "http://nickydewestelinck.be/wp-content/icons/salesforce.ico"
$DestinationIcon = "C:\URLIcon\salesforce.ico"

Step 1 will create a folder on your device, it will be located at C:\URLIcon\.

#Step 1 - Create a folder to place the URL icon
New-Item $LocalIconFolderPath -Type Directory

Step 2 will download the .ico file and create one locally in the previously created folder. We use cURL for this part, more information here on cURL.

#Step 2 - Download a ICO file from a website into previous created folder
curl $SourceIcon -o $DestinationIcon

The last part will create the URL shortcut, with the custom icon, to the Public Desktop folder on the device.

#Step 3 - Add the custom URL shortcut to your Desktop with custom icon
$new_object = New-Object -ComObject WScript.Shell
$destination = $new_object.SpecialFolders.Item('AllUsersDesktop')
$source_path = Join-Path -Path $destination -ChildPath '\\Salesforce.lnk'
$source = $new_object.CreateShortcut($source_path)
$source.TargetPath = 'https://login.salesforce.com'
$source.IconLocation = ”C:\URLIcon\salesforce.ico”
$source.Save()

Copy the code above and copy it into an editor like Powershell ISE or Visual Studio Code.

#Variables creating local folder and download .ico file
$LocalIconFolderPath = "C:\URLIcon"
$SourceIcon = "http://nickydewestelinck.be/wp-content/icons/salesforce.ico"
$DestinationIcon = "C:\URLIcon\salesforce.ico"


#Step 1 - Create a folder to place the URL icon
New-Item $LocalIconFolderPath -Type Directory

#Step 2 - Download a ICO file from a website into previous created folder
curl $SourceIcon -o $DestinationIcon

#Step 3 - Add the custom URL shortcut to your Desktop with custom icon
$new_object = New-Object -ComObject WScript.Shell
$destination = $new_object.SpecialFolders.Item('AllUsersDesktop')
$source_path = Join-Path -Path $destination -ChildPath '\\Salesforce.lnk'
$source = $new_object.CreateShortcut($source_path)
$source.TargetPath = 'https://login.salesforce.com'
$source.IconLocation = ”C:\URLIcon\salesforce.ico”
$source.Save()

Now save this PowerShell script to your local computer as a .ps1 file. I named it Create-Desktop-URL-Shortcuts.ps1.

Step 2: Deploy script with Microsoft Intune

Go to https://endpoint.microsoft.com and sign-in with a Global Administrator or Intune Administrator.

Go to Devices => Scripts. Then click on +Add and choose for Windows 10.

how-to-deploy-custom-url-shortcuts-with-microsoft-intune

Give the Script a name. In this example it will be NDW – Add Custom URL shortcut to Desktop and click Next.

Choose the PowerShell script created and saved in Step 1. Leave the extra settings as default.

Assign it to All Devices or a group to those who need the deployment and click Next.

Review your settings and click Add. Your script will now be added.

Your script is now added and ready to deploy to the requested devices.

So this is how to deploy custom URL shortcuts with Microsoft Intune. Isn’t that difficult is it?

So this was the first post in my “Cases from the Field” series. Stay tuned for more…

Nicky De Westelinck

Nicky De Westelinck is a Modern Workplace Consultant for Wortell Belgium with several years of experience in Microsoft 365. His main focus is Microsoft EndPoint Manager and Microsoft 365 Administration. He is also a Microsoft Certified Trainer since 2021.

View all posts by Nicky De Westelinck →

45 thoughts on “How to deploy custom URL shortcuts with Microsoft Intune”

Michael Flynn says:

07/04/2021 at 7 April 2021

Any way to have this force use Internet Explorer? I have some legacy apps that only launch from IE.

Reply
1. Nicky De Westelinck says:
  
  17/09/2021 at 17 September 2021
  
  Sorry for my late reaction! Currently I’ve only done this for Microsoft Edge.
  
  Reply
2. EUCE says:
  
  26/04/2023 at 26 April 2023
  
  Edge y compatibilidad con IE y la versión, y agregar la condición.
  
  Reply
Till says:

04/08/2021 at 4 August 2021

Excellent, is there any way to add a custom icon ?

Reply
1. Nicky De Westelinck says:
  
  17/09/2021 at 17 September 2021
  
  You can try by adding an extra line to the script.
  $source.IconLocation=”iconfile.ico, 0″
  
  Reply
  1. jon says:
    
    07/02/2022 at 7 February 2022
    
    Hi. I too want to add a custom logo, but get this error after trying to add the additional line:
    
    Exception setting “IconLocation”: “The property ‘IconLocation’ cannot be found on this object. Verify that the property exists and can be set.
    
    Can you or any of your readers please suggest a fix?
    
    Reply
    1. Nicky De Westelinck says:
      
      19/04/2022 at 19 April 2022
      
      Is your icon location path available from the device? Can you provide a screenshot of your script?
      
      Reply
  2. Levin van Hoorne says:
    
    15/09/2022 at 15 September 2022
    
    Kan je ook bij logo locatie de URL doen waar het logo staat ?
    
    Reply
    1. Nicky De Westelinck says:
      
      15/09/2022 at 15 September 2022
      
      Hi Levin,
      
      Gonna answer this in English if you don’t mind. Didn’t tried it myself but I think a URL should work to, as long it’s publically reachable.
      
      Regards,
      Nicky
      
      Reply
      1. Levin says:
        
        21/09/2022 at 21 September 2022
        
        Didn’t work. I did this by example on powershell.
        
        $source.IconLocation= ”https://www.voys.nl/app/themes/voys/dist/images/logo.svg”
        
        Can you see the problem??
      2. Nicky De Westelinck says:
        
        04/10/2022 at 4 October 2022
        
        Hi Levin,
        
        Apologies for the late reaction, but I was on Holiday. I tried it myself, but it seems that the URLs aren’t working.
        I going to try to make some time to check out a solution by creating a W32 app. I’ll keep you posted.
      3. Nicky De Westelinck says:
        
        04/10/2022 at 4 October 2022
        
        Hi Levin,
        
        I’ve updated the script, but be sure to convert your .svg file to a .ico file. I used this this site => https://www.xiconeditor.com/.
        And instead of using the .URL in the link, you should change it to .lnk. That’s why the IconLocation property doesn’t work.
        
        I added some extra lines to the script. Steps are explained in the title. I’ve tested it in Sandbox and it worked.
        
        #Step 1 – Create a folder to place the URL icon
        New-Item “C:\URLIcon” -Type Directory
        
        #Step 2 – Download a ICO file from a website into previous created folder
        curl “http://nickydewestelinck.be/wp-content/icons/favicon.ico” -o C:\URLIcon\salesforce.ico
        
        #Step 3 – Add the custom URL shortcut to your Desktop with custom icon
        $new_object = New-Object -ComObject WScript.Shell
        $destination = $new_object.SpecialFolders.Item(‘Desktop’)
        $source_path = Join-Path -Path $destination -ChildPath ‘\\Salesforce.lnk’
        $source = $new_object.CreateShortcut($source_path)
        $source.TargetPath = ‘http://login.salesforce.com’
        $source.IconLocation = ”C:\URLIcon\salesforce.ico”
        $source.Save()
        
        Regards,
        Nicky
      4. Levin says:
        
        13/10/2022 at 13 October 2022
        
        Thanks for your info. If i deploy my script in Intune it doesn’t work. The script created a directory with the icon but the shortcut self isn’t visible. They only thing what is maybe the problem is that or organization policy blocked it. I think that is not the problem because without the icon the script works totally. Any idea what is happening??
      5. Nicky De Westelinck says:
        
        19/10/2022 at 19 October 2022
        
        Can you show me your full script?
Richard Garcia says:

22/09/2021 at 22 September 2021

If users don’t have elevated privileges will it still add the shortcut without admin rights?

Reply
1. Nicky De Westelinck says:
  
  19/04/2022 at 19 April 2022
  
  Normally it should do the trick. 🙂
  
  Reply
Steve the Tech says:

22/09/2021 at 22 September 2021

+My company has Android and Apple devices in Intune. I’ve been tasked with pushing a company website shortcut to all the Apple devices. I tried the script and it immediately says the uploaded file isn’t a valid script. Is there a wayto do this for iOs devices in Intune?

Reply
1. Nicky De Westelinck says:
  
  07/10/2021 at 7 October 2021
  
  This post is for Windows 10/11 devices and won’t work on iOS devices. Not sure if this is possible for iOS in Intune.
  
  Reply
Opeyemi says:

30/01/2022 at 30 January 2022

Hi, thanks for the post. is there a universal repository of icons url hosted online that can be used to replace the internet explorer logo? If you know of any kindly point

Reply
1. Nicky De Westelinck says:
  
  19/04/2022 at 19 April 2022
  
  Not that I know off, but interesting question. Something I need to figure out. 🙂
  
  Reply
Manu Kamboj says:

19/04/2022 at 19 April 2022

script is working fine but it is opening in Edge browser, Please suggest, how I can set it as Chrome instead of Edge.

Reply
1. Nicky De Westelinck says:
  
  19/04/2022 at 19 April 2022
  
  Is Chrome set as the default browser on your client? This script normally uses the default browser of the client and not just Microsoft Edge.
  
  Reply
Mike Halsey says:

26/04/2022 at 26 April 2022

I would love to use this for creating shortcuts but, when I try to run the script in step 1 in an elevated Powershell window I just get the following error:-

Unable to save shortcut “C:\Users\Public\Desktop\Salesforce.url”.
At line:7 char:1
+ $source.Save()
+ ~~~~~~~~~~~~~~
+ CategoryInfo : OperationStopped: (:) [], COMException
+ FullyQualifiedErrorId : System.Runtime.InteropServices.COMException

Any ideas on how to resolve this?

Many thanks in advance.

Reply
1. Nicky De Westelinck says:
  
  13/05/2022 at 13 May 2022
  
  Hi Mike,
  Apologies for my late response, I was on vacation for two weeks. 🙂
  I just tried the script and (for some odd reason) I received the same error. I managed to get it working by changing the $destination variable to “Desktop” instead of “AllUsersDesktop”.
  This worked for me, here is the “new script”.
  
  $new_object = New-Object -ComObject WScript.Shell
  $destination = $new_object.SpecialFolders.Item(“Desktop”)
  $source_path = Join-Path -Path $destination -ChildPath “\\Salesforce.url”
  $source = $new_object.CreateShortcut($source_path)
  $source.TargetPath = “http://login.salesforce.com”
  $source.Save()
  
  Greetings,
  Nicky
  
  Reply
nadir Ummer says:

14/05/2022 at 14 May 2022

Hi,

Can i add more than one shortcut using the above script??

Reply
1. Nicky De Westelinck says:
  
  01/06/2022 at 1 June 2022
  
  Hi,
  
  Yes you can. Just copy these commands multiple times in the same script and change the path. For example:
  
  # Add Salesforce Shortcut $new_object = New-Object -ComObject WScript.Shell $destination = $new_object.SpecialFolders.Item(“Desktop”) $source_path = Join-Path -Path $destination -ChildPath “\\Salesforce.url” $source = $new_object.CreateShortcut($source_path) $source.TargetPath = “http://login.salesforce.com” $source.Save()
  #Add Google shortcut $new_object = New-Object -ComObject WScript.Shell $destination = $new_object.SpecialFolders.Item(“Desktop”) $source_path = Join-Path -Path $destination -ChildPath “\\Google.url” $source = $new_object.CreateShortcut($source_path) $source.TargetPath = “http://www.google.com” $source.Save()
  
  Greetings,
  Nicky
  
  Reply
Roni Roni says:

13/06/2022 at 13 June 2022

Hi Nicky

How we can delete the shortcut?

Thanks
Roni

Reply
1. Nicky De Westelinck says:
  
  11/07/2022 at 11 July 2022
  
  You can create a second script with a delete command and assign it to users who don’t need the shortcut anymore.
  
  Regards.
  
  Reply
Tommy Bhry says:

08/07/2022 at 8 July 2022

Hi Nicky,

Thanks for the script! Is there a line of code or a way to ensure that if an existing shortcut with the same name, i.e. salesforce.url is already present, to overwrite this rather than creating an additional one?

Reply
1. Nicky De Westelinck says:
  
  11/07/2022 at 11 July 2022
  
  Hi Tommy,
  
  Not for now, need to check this out.
  
  Regards.
  
  Reply
MaR says:

09/07/2022 at 9 July 2022

Thanks Nicky! Just in time for my customer. 🙂

Reply
MaR says:

09/07/2022 at 9 July 2022

Hi Nicky,

I’m able to run local with elevated privileges but this fails as per you script settings. I even select to run on 64bit host as this works on some scripts I’ve deployed via Intune.

Any suggestions?

Thank you!

Reply
1. Nicky De Westelinck says:
  
  11/07/2022 at 11 July 2022
  
  Hi,
  
  Can you try this script?
  $new_object = New-Object -ComObject WScript.Shell
  $destination = $new_object.SpecialFolders.Item(“Desktop”)
  $source_path = Join-Path -Path $destination -ChildPath “\\Salesforce.url”
  $source = $new_object.CreateShortcut($source_path)
  $source.TargetPath = “http://login.salesforce.com”
  $source.Save()
  
  Regards.
  
  Reply
Brian Shipp says:

19/07/2022 at 19 July 2022

Nicky,

Great script and works like a champ, but I would like to ask about icon again. So I can add the icon file and the extra line to the script, but I would like a suggestion from you. Since the whole point is to push this from InTune, then, in theory, there is no on-prem servers for things like storage of .ico files. If you had no file/DC servers, where in Azure would you store the .ico file itself?

Appreciate any recommendations,
Brian

Reply
1. Nicky De Westelinck says:
  
  28/07/2022 at 28 July 2022
  
  Hi Brian,
  
  You could try using Azure Blob Storage for this.
  https://docs.microsoft.com/en-us/azure/storage/blobs/storage-blobs-introduction
  
  Greetz,
  Nicky
  
  Reply
Salvatore De Crescenzo says:

19/08/2022 at 19 August 2022

Hi Nicky,

First of all, thank you for the code, it was exactly what I was looking for and it works brilliantly. Now for the second part, on how to delete previously added links, by googling I found something like this:

$Icon1 = “Salesforce.lnk”
If ((Test-Path “$env:AllUsers\Desktop\$Icon1”) -eq $true)
{
Remove-Item “$($env:AllUsers)\Desktop\$Icon1” –Force
}

Would something like this work?

Regards

Reply
1. Nicky De Westelinck says:
  
  19/08/2022 at 19 August 2022
  
  Hi Salvatore,
  
  Big thanks for your feedback, it’s much appreciated! 😉
  What I always do for testing such scripts is, open Windows Sandbox and run those scripts there.
  The first step is to run the script that creates the link (as written in the blog), then run your script (the one above) to see if the link is removed. If it’s the case, I think your script works perfectly and you can deploy it. 😉
  
  Regards!
  
  Reply
Titou says:

05/05/2023 at 5 May 2023

Hi,

My script is a bit different, but it does the same thing. When i manually execute it on the desktop , it works perfectly fine, but in the deployment with intune autopilot, it break because it try to put the shortcut in this :
“C:\WINDOWS\system32\config\systemprofile\Desktop\Google-Chrome.lnk”.

I think that it try to put shortcut while being in a special profil for installing so he don’t find the right profil. Here is my script :

$shell = New-Object -ComObject WScript.Shell
$appName = “Google-Chrome”
$appPath = “C:\Program Files\Google\Chrome\Application\chrome.exe”
$iconPath = $appPath

# Récupération du chemin du profil utilisateur
$userProfile = $env:USERPROFILE
$lg = “Desktop”
$shortcutPath = “$userProfile\$lg\$appName.lnk”
$shortcut = $shell.CreateShortcut($shortcutPath)
$shortcut.TargetPath = $appPath
$shortcut.IconLocation = $iconPath
$shortcut.Save()

$appName = “Wordd”
$appPath = “C:\Program Files\Microsoft Office\root\Office16\WINWORD.exe”
$iconPath = $appPath

# Récupération du chemin du profil utilisateur
$userProfile = $env:USERPROFILE
$shortcutPath = “$userProfile\$lg\$appName.lnk”
$shortcut = $shell.CreateShortcut($shortcutPath)
$shortcut.TargetPath = $appPath
$shortcut.IconLocation = $iconPath
$shortcut.Save()

# RAJOUTER \OneDrive\ ENTRE USERPROFILE ET LG SI L’UTILISATEUR VA UTILISER ONEDRIVE

Reply
Chris says:

18/05/2023 at 18 May 2023

Hi There,

I have managed to deploy a shortcut to my desktop following your guide. It also has a custom Icon which is great. Intune has pushed this out perfectly.

however, when double clicking the shortcut on my desktop it comes up with “Missing Shortcut”? Have I done something wrong? This is the code I have used! Any help will be much appreciated.

I also have a URLIcon on my C Drive containing the .ico file.

“FYI Line 3 SourceIcon I have removed the blob storage URL for security reasons on this feed. But rest assured its in there when deploying the script!”

#Variables creating local folder and download .ico file
$LocalIconFolderPath = “C:\URLIcon”
$SourceIcon = “Removed”
$DestinationIcon = “C:\URLIcon\Ulysses Incident Reporting.ico”

#Step 1 – Create a folder to place the URL icon
New-Item $LocalIconFolderPath -Type Directory

#Step 2 – Download a ICO file from a website into previous created folder
curl $SourceIcon -o $DestinationIcon

#Step 3 – Add the custom URL shortcut to your Desktop with custom icon
$new_object = New-Object -ComObject WScript.Shell
$destination = $new_object.SpecialFolders.Item(‘AllUsersDesktop’)
$source_path = Join-Path -Path $destination -ChildPath ‘\\Ulysses Incident Reporting.lnk’
$source = $new_object.CreateShortcut($source_path)
$source.TargetPath = ‘ulysses.everyturn.org’
$source.IconLocation = ”C:\URLIcon\Ulysses Incident Reporting.ico”
$source.Save()

Reply
Chris says:

18/05/2023 at 18 May 2023

Hi Guys, sorry never mind I have got it working! I didnt put in the https:// at the front of my URL

This is now resolved. Thanks for your help!!

Reply
1. Nicky De Westelinck says:
  
  18/05/2023 at 18 May 2023
  
  Hi Chris,
  
  You beat me to it. 😉 This was exactly what I was trying to suggest.
  Glad to hear I could help!
  
  Kind regards,
  Nicky
  
  Reply
Gman says:

21/06/2023 at 21 June 2023

Great read and easy-to-follow guide!

Noob question: how often do scripts placed here, run? Every single logon? And if so, does it overwrite this shortcut everytime?

Reply
1. Nicky De Westelinck says:
  
  21/06/2023 at 21 June 2023
  
  Hi Gman,
  
  The Intune Management client will check at logon and only run again if there are changes in the script and will overwrite the current configuration. If there are no changes, it will do nothing.
  
  Reply
James says:

03/07/2023 at 3 July 2023

Love the script, makes things so much easier. Unfortunately, its not deploying the shortcut with the .ico. I see that it downloaded the file in question but is not being used as the icon for the shortcut. Thoughts?

Reply
1. Nicky De Westelinck says:
  
  05/07/2023 at 5 July 2023
  
  Hi James, if you run the script manually on your device does it work? Is the location to the icon correct in the script, it should point to the local UNC path where the .ico file is copied/located ($DestinationIcon = “C:\“)
  I’ve also noticed (during my test) that the .ico file can be corrupted or bad so it wouldn’t show either, did you use to tool mentioned in the post?
  If you want, you can always send your script and I’ll check it out.
  
  Kind regards,
  Nicky
  
  Reply