Add fn for vSphere object type info mining, rename module updater

Author: mtboren

Update-VNModuleManifest.ps1 Update-ThisModuleManifest.ps1Update-VNModuleManifest.ps1 renamed to Update-ThisModuleManifest.ps1

@@ -3,7 +3,7 @@
 #
 # Generated by: Matt Boren
 #
-# Generated on: 6/18/2017
+# Generated on: 1/19/2023
 #
 
 @{
@@ -12,7 +12,7 @@
 RootModule = 'vNuggletsUtilityMod.psm1'
 
 # Version number of this module.
-ModuleVersion = '1.2.0'
+ModuleVersion = '1.3.0'
 
 # Supported PSEditions
 # CompatiblePSEditions = @()
@@ -27,25 +27,25 @@ Author = 'Matt Boren'
 CompanyName = 'vNugglets.com'
 
 # Copyright statement for this module
-Copyright = 'MIT License'
+Copyright = 'Apache 2.0 License'
 
 # Description of the functionality provided by this module
 Description = 'Module with the super useful functions that were previously scattered about the web by the vNugglets team (particularly, at vNugglets.com)'
 
-# Minimum version of the Windows PowerShell engine required by this module
-PowerShellVersion = '4.0'
+# Minimum version of the PowerShell engine required by this module
+PowerShellVersion = '5.0'
 
-# Name of the Windows PowerShell host required by this module
+# Name of the PowerShell host required by this module
 # PowerShellHostName = ''
 
-# Minimum version of the Windows PowerShell host required by this module
+# Minimum version of the PowerShell host required by this module
 # PowerShellHostVersion = ''
 
 # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
 # DotNetFrameworkVersion = ''
 
 # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
-# CLRVersion = ''
+# ClrVersion = ''
 
 # Processor architecture (None, X86, Amd64) required by this module
 # ProcessorArchitecture = ''
@@ -71,11 +71,12 @@ NestedModules = @('vNuggletsUtilityMod_functions.ps1',
 
 # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
 FunctionsToExport = 'Connect-VNVIServer', 'Copy-VNVIRole', 'Disconnect-VNVIServer', 
-               'Find-VNVMWithDuplicateMACAddress', 'Get-VNNetworkClusterInfo', 
-               'Get-VNUplinkNicForVM', 'Get-VNVMByAddress', 'Get-VNVMByRDM', 
-               'Get-VNVMByVirtualPortGroup', 'Get-VNVMDiskAndRDM', 'Get-VNVMEVCInfo', 
-               'Get-VNVMHostBrokenUplink', 'Get-VNVMHostFirmwareInfo', 
-               'Get-VNVMHostHBAWWN', 'Get-VNVMHostLogicalVolumeInfo', 
+               'Find-VNVMWithDuplicateMACAddress', 'Get-VNInventoryType', 
+               'Get-VNNetworkClusterInfo', 'Get-VNUplinkNicForVM', 
+               'Get-VNVMByAddress', 'Get-VNVMByRDM', 'Get-VNVMByVirtualPortGroup', 
+               'Get-VNVMDiskAndRDM', 'Get-VNVMEVCInfo', 'Get-VNVMHostBrokenUplink', 
+               'Get-VNVMHostFirmwareInfo', 'Get-VNVMHostHBAWWN', 
+               'Get-VNVMHostLogicalVolumeInfo', 
                'Get-VNVMHostNICFirmwareAndDriverInfo', 
                'Invoke-VNEvacuateDatastore', 'Move-VNTemplateFromVMHost', 
                'Update-VNTitleBarForPowerCLI'
@@ -111,7 +112,7 @@ PrivateData = @{
         Tags = 'vNugglets','vNugglets.com','VMware','vSphere','FaF','PowerCLI','VIRole','MAC','VM','RDM','vPG','VirtualPortgroup','EVC','VMHost','HBA','Datastore'
 
         # A URL to the license for this module.
-        LicenseUri = 'https://github.com/vNugglets/vNuggletsPSMod/blob/master/License'
+        LicenseUri = 'https://github.com/vNugglets/vNuggletsPSMod/blob/main/License'
 
         # A URL to the main website for this project.
         ProjectUri = 'https://github.com/vNugglets/vNuggletsPSMod'
@@ -120,13 +121,19 @@ PrivateData = @{
         IconUri = 'http://static.vnugglets.com/imgs/vNuggletsLogo.jpg'
 
         # ReleaseNotes of this module
-        ReleaseNotes = 'See release notes at https://github.com/vNugglets/vNuggletsPSMod/blob/master/ChangeLog.md'
+        ReleaseNotes = 'See release notes at https://github.com/vNugglets/vNuggletsPSMod/blob/main/ChangeLog.md'
+
+        # Prerelease string of this module
+        # Prerelease = ''
+
+        # Flag to indicate whether the module requires explicit user acceptance for install/update/save
+        # RequireLicenseAcceptance = $false
 
         # External dependent modules of this module
-        # ExternalModuleDependencies = ''
+        # ExternalModuleDependencies = @()
 
     } # End of PSData hashtable
-    
+
  } # End of PrivateData hashtable
 
 # HelpInfo URI of this module

vNugglets.Utility/vNugglets.Utility.psd1

@@ -1428,3 +1428,45 @@ function Invoke-VNEvacuateDatastore {
         } ## end foreach-object
     } ## end process
 } ## end fn
+
+
+function Get-VNInventoryType {
+<#	.Description
+    Function to determine possible "correct" object type(s) to use from a vSphere inventory object, as described by Alan Renouf at http://blogs.vmware.com/PowerCLI/2016/04/powercli-best-practice-correct-use-strong-typing.html.
+
+    This is super helpful for when trying to determine most future-"safe" VMware object model types to use for parameter type-ing for our own functions/cmdlets
+
+    .Example
+    Get-DatastoreCluster myDSCluster0 | Get-VNInventoryType
+    Name              FullName
+    ----              --------
+    DatastoreCluster  VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.DatastoreCluster
+
+    .Example
+    Get-VM myVM0 | Get-VNInventoryType -ReturnTypesType
+    Get the parent types of the VM object's type that include ".Types." in the name, of which "VMware.VimAutomation.Types.VirtualMachine" is probably a winner for subsequent use
+#>
+    [CmdletBinding()]
+    [OutputType([System.Type])]
+    param(
+        ## The vSphere object(s) for which to get so-called "safe" or "correct" Types for use in code
+        [parameter(mandatory=$true,ValueFromPipeline=$true)][VMware.VimAutomation.Sdk.Types.V1.VIObjectCore[]]$RelatedObject,
+
+        ## Switch:  return all types for this object type that contain ".Types." in their full name? (instead of just ones that match the "Impl" type name without the "Impl" string in them)
+        [Switch]$ReturnTypesType
+    ) ## end param
+
+    process {
+        $RelatedObject | Foreach-Object {
+            $oThisEntity = $_
+            $oThisEntityType = $_.GetType()
+            ## if "return all .Types.* types" switch is $true, return the full list of supported ".Types." types for this object
+            $(if ($ReturnTypesType) {$oThisEntityType.GetInterfaces() | Where-Object {$_.FullName -like "*.Types.*"}}
+            else {
+                ## get the "future-safer" full type info for this object type, if any (essentially the same typename, but without the "Impl" portion in the it, if there is such a type)
+                $oThisEntityType.GetInterfaces() | Where-Object {($_.FullName -like "*.Types.*") -and ($_.Name -eq $oThisEntityType.Name.Replace("Impl", ""))}
+            } ## end else
+            ) | Select-Object Name, FullName, @{n="RelatedObject"; e={$oThisEntity}}
+        } ## end foreach-object
+    } ## end process
+}