Public/CimObject.ps1
|
<#
.SYNOPSIS Test the value of a CimObject Property. .DESCRIPTION Test the value of a CimObject Property. The Class can be provided with the Namespace. See Example. .PARAMETER Target Specifies the name of the CIM class for which to retrieve the CIM instances. Can be just the ClassName in the default namespace or in the form of namespace/className to access other namespaces. .PARAMETER Property Specifies an instance property to retrieve. .PARAMETER Should A Script Block defining a Pester Assertion. .EXAMPLE CimObject Win32_OperatingSystem SystemDirectory { Should Be C:\WINDOWS\system32 } .EXAMPLE CimObject root/StandardCimv2/MSFT_NetOffloadGlobalSetting ReceiveSideScaling { Should Be Enabled } .NOTES Assertions: Be, BeExactly, Match, MatchExactly #> function CimObject { [CmdletBinding()] param( [Parameter(Mandatory, Position=1)] [Alias("ClassName")] [string]$Target, [Parameter(Mandatory, Position=2)] [string]$Property, [Parameter(Mandatory, Position=3)] [scriptblock]$Should ) $expression = "Get-CimInstance" if ($Target -match '/') { $lastIndexOfSlash = $Target.LastIndexOf('/') $class = $Target.Substring($lastIndexOfSlash + 1) $namespace = $Target.Substring(0,$lastIndexOfSlash) $PSBoundParameters["Target"] = $class $PSBoundParameters.Add("Qualifier", $namespace) $expression = {Get-CimInstance -ClassName $Target -Namespace $Qualifier} } else { $expression = {Get-CimInstance -ClassName $Target} } $params = Get-PoshspecParam -TestName CimObject -TestExpression $expression @PSBoundParameters Invoke-PoshspecExpression @params } |