PowerShell Substring Function Explained With Examples

by | Blog

Working with text in PowerShell? Then you’re going to love the Substring function. It’s one of the handiest tools for slicing and dicing strings. And the best part? It’s super easy to use!

Let’s dive into what it does and how you can use it, all while keeping things simple and fun!

What is Substring?

The Substring method helps you take a part of a string. You don’t always need the whole thing, right? Sometimes, a small piece is just perfect.

Here’s the basic format:

$string.Substring(startIndex, length)
  • startIndex – Where to begin (starts at 0).
  • length – How many characters you want (optional).

If you skip length, PowerShell will return everything from startIndex to the end.

Let’s Slice a String!

$text = "PowerShell is amazing!"
$part = $text.Substring(0, 10)
Write-Output $part

What do you get? PowerShell. Easy, right?

We started at position 0 and grabbed 10 characters. Think of it like picking the first 10 letters from a line of text.

Just Starting Somewhere

What if you only want everything after a certain point?

$text = "I love scripting!"
$rest = $text.Substring(7)
Write-Output $rest

You’ll see: scripting!. See? Just started at position 7 and kept going.

Using Variables with Substring

You don’t have to hard-code the numbers. You can calculate them too!

$message = "Get the middle word"
$start = 8
$length = 6
$word = $message.Substring($start, $length)
Write-Output $word

That gives us: middle.

This is great when you’re not sure where things will appear, especially in longer texts.

Let the Words Find Themselves

Let’s imagine you want to grab something between two known points.

$line = "User: JohnDoe"
$colonPos = $line.IndexOf(":")
$name = $line.Substring($colonPos + 2)
Write-Output $name

Results in: JohnDoe.

We find the position of “:”, skip the space, and grab the rest!

Watch Out for Errors!

If you try to grab more characters than the string has, you’ll get an error. PowerShell doesn’t like that.

$text = "Oops"
$bad = $text.Substring(0, 10)   # This will cause an error

Tip: Always check the length first:

if ($text.Length -ge 10) {
    $safe = $text.Substring(0, 10)
}

Real-World Fun Example

Let’s pull usernames from an email!

$email = "alice@example.com"
$atPos = $email.IndexOf("@")
$username = $email.Substring(0, $atPos)
Write-Output $username

What do you get? alice. Yup—we trimmed out the domain part.

A Quick Recap

  • Substring lets you grab a piece of a string.
  • Use startIndex to tell it where to start.
  • Use length to say how far to go.
  • Leave out length to go to the end.
  • Use IndexOf() to make it smarter!

Why You’ll Love Using It

The Substring function is perfect when:

  • You need a username from an email.
  • You want just the date from a timestamp.
  • You’re formatting text outputs.

Strings are everywhere in scripts. Knowing how to trim them makes you powerful—like a string ninja!

Go Slice Things!

Now that you know how Substring works, try it out. Grab pieces of text, extract info, and impress your friends. It’s simple, quick, and mighty useful.

Happy scripting!

Pin It on Pinterest