When writing PowerShell scripts that collect information from a data source with many items, it's common to filter out some of those items with the Where-Object cmdlet. The Where-Object cmdlet allows a scripter to provide a scriptblock that, when executed, returns a boolean value that restricts the items sent to the pipeline.

For example, perhaps I'm querying files in a particular folder with the Get-ChildItem cmdlet and want to find all files changed only within the past ten days. One way I could do this is by using Where-Object and the FilterScript parameter.

This works well as is, but what if the criteria you're using for FilterScript change depending on input in a script or function? Perhaps this line is part of a script that finds files ten days or older sometimes, but other times you want to find files older than ten days. In this case, the FilterScript scriptblock will change. But instead of duplicating code in each scenario, it's best to change what only needs changing: the value for FilterScript.

To demonstrate, let's wrap this line in a fictional function of some sort that allows the user to query files in a folder either older than or newer than a number of days. If we duplicated this line, it might look something like the code below:

Displaying files that have changed within the past 10 days

Displaying files that have changed within the past 10 days

This function does what we intended, but it's not the best. We're duplicating the Get-ChildItem references when we don't have to. Instead, the scriptblock used with the FilterScript parameter needs to change. Since the value of FilterScript is just a scriptblock, we can define it as a variable ahead of time and make that change based on input from the function parameters.

This is just a simple example of how you can use this technique. By moving the value of FilterScript to a variable, you can build these dynamic filter scripts and pass them to whichever command you're filtering in PowerShell!

Join the 4sysops PowerShell group!

Your question was not answered? Ask in the forum!

  1. 3+
  2. G4rp 2 years ago

    Dear Adam,

    thanks for the good post!

    For learning purpose I would like to improve the function and validate that the two switches cannot be used together.

    Any idea how to do it?




Leave a reply

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


© 4sysops 2006 - 2020


Please ask IT administration questions in the forums. Any other messages are welcome.


Log in with your credentials


Forgot your details?

Create Account