functions/find-cimclass.ps1
|
#search WMI for a class Function Find-CimClass { [CmdletBinding()] [alias('fcc')] [OutputType([Microsoft.Management.Infrastructure.CimClass])] Param( [Parameter(Position = 0, Mandatory, HelpMessage = "Enter the name of a CIM/WMI class. Wildcards are permitted.")] [ValidateNotNullOrEmpty()] [string]$ClassName, [Parameter(HelpMessage = "Enter a pattern for class names to EXCLUDE from the results. You can use wildcards or regular expressions.")] [string]$Exclude, [Parameter(HelpMessage = "Enter the name of a computer to search.")] [ValidateNotNullOrEmpty()] [string]$Computername = $env:COMPUTERNAME ) Write-Verbose "Starting $($MyInvocation.MyCommand)" #the command requires CIM cmdlets which won't work on non-Windows platforms. if ((Test-IsPSWindows)) { #define a hashtable of parameters to splat to Write-Progress $progParams = @{ Activity = $MyInvocation.MyCommand PercentComplete = 0 Status = "Enumerating namespaces on $($Computername.ToUpper())" CurrentOperation = "Creating temporary CIMSession" } Write-Progress @progParams Write-Verbose "Creating a temporary CIMSession to $($Computername.ToUpper())." Try { $cs = New-CimSession -ComputerName $computername -ErrorAction Stop } Catch { Write-Warning "Failed to connect to $($Computername.ToUpper())" Write-Warning $_.exception.Message #bail out of the function return } $progParams.CurrentOperation = "Building namespace list" #build a list of namespaces Function _enumnamespace { [cmdletbinding()] Param( [string]$Namespace = "Root", [cimsession]$session ) Get-CimInstance -Namespace $namespace -ClassName __Namespace -cimsession $session | ForEach-Object { $n = Join-Path $Namespace $_.Name #write the namespace path to the pipeline $n #recurse through each namespace _enumnamespace -Namespace $n -session $session } } #build a list of namespaces $namespaces = _enumnamespace -session $CS | Sort-Object #enumerate namespaces and search for the class Write-Verbose "Searching for class $class" if ($Exclude) { Write-Verbose "Using an exclude pattern of $Exclude" } $i = 0 foreach ($ns in $namespaces) { $i++ $pct = ($i / $namespaces.count) * 100 $progParams.PercentComplete = $pct $progParams.Status = "Searching for class $ClassName in $($namespaces.count) namespaces" $progParams.CurrentOperation = "processing \\$($computername.ToUpper())\$ns" Write-Progress @progparams Write-Verbose $ns Try { $classes = Get-CimClass -Namespace $ns -ClassName $ClassName -CimSession $cs -ErrorAction Stop if ($classes -AND $Exclude) { $classes.Where( { $_.cimClassName -notmatch $Exclude }) | Sort-Object -Property CimClassName } else { $classes | Sort-Object -Property CimClassName } } Catch { #ignore error if class not found } } #foreach ns Write-Verbose "Removing temporary CIMSession" $cs | Remove-CimSession } else { Write-Warning "This command requires a Windows platform." } Write-Verbose "Ending $($MyInvocation.MyCommand)" } #close function |