This PowerShell module contains commands that make it easier to work with type extensions. Many of these commands are wrappers for built-in tools like Get-TypeData or Update-TypeData.
You can the current release from the PowerShell Gallery:
Install-Module PSTypeExtensionToolsLet's say you want to update a number object, but you have no idea what the type name is. Once you have read help for the commands in this module you could run a PowerShell command like this:
PS C:\> 123 | Get-PSType | Add-PSTypeExtension -MemberType ScriptProperty -MemberName SquareRoot -Value { [math]::Sqrt($this)}Use $this to reference the object instead of $_. Now you can get the new property.
PS C:\> $x = 123
PS C:\> $x.SquareRoot
11.0905365064094Once you know the type name you can add other type extensions.
PS C:\> Add-PSTypeExtension -TypeName system.int32 -MemberType ScriptProperty -MemberName Squared -value { $this*$this}
PS C:\> Add-PSTypeExtension -TypeName system.int32 -MemberType ScriptProperty -MemberName Cubed -value { [math]::Pow($this,3)}
PS C:\> Add-PSTypeExtension -TypeName system.int32 -MemberType ScriptProperty -MemberName Value -value { $this}
PS C:\> Add-PSTypeExtension -TypeName system.int32 -MemberType ScriptMethod -MemberName GetPercent -value {Param([int32]$Total,[int32]$Round=2) [math]::Round(($this/$total)*100,$round)}
Here's how it might look:
PS C:\> $x = 38
PS C:\> $x | select *
SquareRoot Squared Cubed Value
---------- ------- ----- -----
6.16441400296898 1444 54872 38
PS C:\> $x.GetPercent(50)
76
PS C:\> $x.GetPercent(100)
38
PS C:\> $x.GetPercent(110,4)
34.5455To see what has been defined you can use Get-PSTypeExtension. You can choose to see all extensions or selected ones by member name.
PS C:\> Get-PSTypeExtension system.int32
TypeName: System.Int32
Name Type Value
---- ---- -----
SquareRoot ScriptProperty [math]::Sqrt($this)
Squared ScriptProperty $this*$this
Cubed ScriptProperty [math]::Pow($this,3)
Value ScriptProperty $this
GetPercent ScriptMethod Param([int32]$Total,[int32]$Round=2) [math]::Round(($this/$total)*100,$round)If you always want these extensions you would have to put the commands into your PowerShell profile script. Or you can export the extensions to a json or xml file. You can either export all members or selected ones which is helpful if you are extending a type that already has type extensions from PowerShell.
PS C:\> Get-PSTypeExtension system.int32 | Export-PSTypeExtension -TypeName system.int32 -Path c:\work\int32-types.jsonIn your PowerShell profile script you can then re-import the type extension definitions.
Import-PSTypeExtension -Path C:\work\int32-types.jsonThe export command makes it easy to construct a ps1xml file. All you need to do is provide the type name and the extensions you want to export, and it will create a properly formatted ps1xml file that you can import into a session with Update-TypeData or distribute with a module. No more clunky XML copying, pasting and hoping for the best.
Add a new type extension such as an Alias or ScriptProperty.
Export type extensions to a json, xml or ps1xml file.
Get the type name of an object.
Get type extensions for a given type.
Import type extension definitions from a json file or xml.
You can find a number of type extension exports in the Samples folder. The location will be saved to a global variable, $PSTypeSamples. This makes it a bit easier to import.
PS C:\> dir $PSTypeSamples
Directory: C:\scripts\PSTypeExtensionTools\samples
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 12/15/2017 2:25 PM 766 cimlogicaldisk-extensions.json
-a---- 9/28/2018 9:48 AM 265 datetime-extensions.json
-a---- 12/15/2017 5:09 PM 232 eventlog-type.json
-a---- 2/18/2019 1:18 PM 1266 fileinfo-extensions.json
-a---- 11/13/2017 8:37 AM 901 int32-types.json
-a---- 11/1/2017 6:18 PM 653 measure-extensions.json
-a---- 11/13/2017 8:49 AM 890 process-types.xml
-a---- 12/15/2017 6:09 PM 628 README.md
-a---- 12/15/2017 2:09 PM 1246 stringtypes.json
-a---- 11/9/2017 12:08 PM 3024 vm-extensions.json
PS C:\> Import-PSTypeExtension $PSTypeSamples\measure-extensions.json -Verbose
VERBOSE: Starting: Import-PSTypeExtension
VERBOSE: Importing file C:\scripts\PSTypeExtensionTools\samples\measure-extensions.json
VERBOSE: Processing ScriptProperty : SumKB
VERBOSE: Creating scriptblock from value
VERBOSE: Performing the operation "Adding ScriptProperty SumKB" on target "Microsoft.PowerShell.Commands.GenericMeasureInfo".
VERBOSE: Processing ScriptProperty : SumMB
VERBOSE: Creating scriptblock from value
VERBOSE: Performing the operation "Adding ScriptProperty SumMB" on target "Microsoft.PowerShell.Commands.GenericMeasureInfo".
VERBOSE: Processing ScriptProperty : SumGB
VERBOSE: Creating scriptblock from value
VERBOSE: Performing the operation "Adding ScriptProperty SumGB" on target "Microsoft.PowerShell.Commands.GenericMeasureInfo".
VERBOSE: Ending: Import-PSTypeExtension
PS C:\> dir D:\VMDisks\ -file -Recurse | measure length -sum | select Count,SumGB
Count SumGB
----- -----
4 50.2031This project was first described at http://jdhitsolutions.com/blog/powershell/5777/a-powershell-module-for-your-type-extensions
There is also an about topic you can read:
help about_PSTypeExtensionToolsLast Updated 2019-09-21 06:15:09Z UTC