Added command: ConvertTo-PSFHashtable

PSFramework/PSFramework.psd1

@@ -66,6 +66,7 @@
 		'Clear-PSFResultCache',
 		'ConvertFrom-PSFClixml',
 		'ConvertTo-PSFClixml',
+		'ConvertTo-PSFHashtable',
 		'Disable-PSFTaskEngineTask',
 		'Enable-PSFTaskEngineTask',
 		'Export-PSFClixml',

PSFramework/changelog.md

@@ -1,4 +1,7 @@
 # CHANGELOG
+## 0.10.28.???
+ - New: Command ConvertTo-PSFHashtable converts objects into hashtables
+
 ## 0.10.28.144 : 2018-10-28
  - Upd: Module Architecture update
  - Upd: Linked online help for commands (by Andrew Pla)

PSFramework/functions/utility/ConvertTo-PSFHashtable.ps1

@@ -0,0 +1,56 @@
+function ConvertTo-PSFHashtable
+{
+<#
+	.SYNOPSIS
+		Converts an object into a hashtable.
+
+	.DESCRIPTION
+		Converts an object into a hashtable.
+		Can exclude individual properties from being included.
+
+	.PARAMETER Exclude
+		The propertynames to exclude.
+		Must be full property-names, no wildcard/regex matching.
+
+	.PARAMETER InputObject
+		The object(s) to convert
+
+	.EXAMPLE
+		PS C:\> Get-ChildItem | ConvertTo-PSFHashtable
+
+		Scans all items in the current path and converts those objects into hashtables.
+#>
+	[OutputType([System.Collections.Hashtable])]
+	[CmdletBinding()]
+	Param (
+		[string[]]
+		$Exclude,
+
+		[Parameter(ValueFromPipeline = $true)]
+		$InputObject
+	)
+
+	process
+	{
+		foreach ($item in $InputObject)
+		{
+			if ($null -eq $item) { continue }
+			if ($item -is [System.Collections.Hashtable])
+			{
+				$hashTable = $item.Clone()
+				foreach ($name in $Exclude) { $hashTable.Remove($name) }
+				$hashTable
+			}
+			else
+			{
+				$hashTable = @{ }
+				foreach ($property in $item.PSObject.Properties)
+				{
+					if ($property.Name -in $Exclude) { continue }
+					$hashTable[$property.Name] = $property.Value
+				}
+				$hashTable
+			}
+		}
+	}
+}