Use-RegEx: -IncludeInputObject

[StartAutomating]

Describe the Problem
When matching a series of files or functions, Use-Regex does make it easy to pair the match (or extracted match) with the input.

This makes an object pipeline using both pieces of information considerably less elegant.

Describe the solution you'd like

Use-Regex should have a parameter -IncludeInputObject (aliased to -OutputInputObject). This should include the input object in the output when using -Extract.

Describe alternatives you've considered

Use-Regex: -IncludeMatch could signal to include the input object.