Luise Freese

how to use oh-my-posh with PnP PowerShell

What is oh my posh?

Oh-my-posh is an amazing prompt engine that does not only pretty up the terminal you use, but it will ease your work. By using an established theme or creating a new one, you get important information directly in the context of your work, highlighted in the way that works best for you. For example:

  • In which repository am I working in?
  • Which branch?
  • When did I execute a command?
  • On which node.js version am I working?

the M365Princess theme by Luise plus environment variables by Anoop

Making good things even better: A while ago, Luise created her own theme and now Anoop had the idea to level it up:

When interacting with Microsoft 365, most of the times we use the Microsoft 365 platform community driven PowerShell module called PnP PowerShell. One of the first commands we execute while using PnP PowerShell, is Connect-PnPOnline to connect to a SharePoint site. We can now see right in the terminal which SharePoint site we are connected to and which Microsoft 365 tenant the SharePoint site lives in.

These are displayed with the help of a couple of environment variables that are set by PnP PowerShell after running the Connect-PnPOnline command.

In the preview below, the connected SharePoint site is /sites/yoursite which is in the tenant named yourtenant.sharepoint.com

oh my posh M365Princess theme PnP

The original idea to show these values comes from Erwin van Hunen, the father of PnP PowerShell.

How to install oh-my-posh and the theme

To have this experience in Visual Studio Code, complete the following steps:

  1. Install oh-my-posh and posh-git
    • Open the the terminal and run
      • Install-Module oh-my-posh -Scope CurrentUser
      • Install-Module posh-git -Scope CurrentUser
  2. Edit your PowerShell profile in VS Code
    • Open it with code $PROFILE
    • Insert this:
Import-Module oh-my-posh
Import-Module posh-git
Set-PoshPrompt -Theme M365Princess
  1. Install a font
    • Download a font of your choice from Nerdfonts
    • Install a monospace version of that font
    • Open settings in VS Code with CTRL + SHIFT + P and select Preferences: Open settings (JSON)
    • Add (for example) "terminal.integrated.fontFamily": "CaskaydiaCove Nerd Font"
    • Save settings and restart VS Code

Slow prompt?

In case the prompt is responding slow on Windows OS, then one of the reasons might be the oh-my-posh process being blocked by Windows defender. To overcome that, please run PowerShell with elevated permissions (Run as administrator) and execute the following command:

Add-MpPreference -ExclusionProcess "oh-my-posh.exe"

If that doesn’t solve the problem then, execute the following command

Add-MpPreference -ExclusionPath "$env:POSH_PATH\oh-my-posh.exe"

For more information see the comments this issue.

Conclusion

It’s the little things! Of course this is just one puzzle tile, but better overview, crucial information presented in a minimal but nerdy and compelling way helps people to ease their workloads. When working with PnP PowerShell, it’s a game changer to know to which of your tenants and sites you are connected to.

If you like the oh-my-posh and can afford it, go buy Jan, who builds and maintains this awesome open source project, a coffee ☕: oh-my-posh repository

sharing is caring

This post was written by Luise Freese and Anoop Tatti

You May Also Like

Want to work with me?