Scripts/Get-BPACondition.ps1
|
function Get-BPACondition { <# .SYNOPSIS Gets AutoMate BPA conditions. .DESCRIPTION Get-BPACondition gets condition objects from AutoMate BPA. Get-BPACondition can receive items on the pipeline and return related objects. .PARAMETER InputObject The object(s) use in search for conditions. .PARAMETER Name The name of the condition (case sensitive). Wildcard characters can be escaped using the ` character. If using escaped wildcards, the string must be wrapped in single quotes. For example: Get-BPACondition -Name '`[Test`]' .PARAMETER ID The ID of the condition. .PARAMETER FilterSet The parameters to filter the search on. Supply hashtable(s) with the following properties: Property, Comparator, Value. Valid values for the Comparator are: =, !=, <, >, contains (default - no need to supply Comparator when using 'contains') .PARAMETER FilterSetMode If multiple filter sets are provided, FilterSetMode determines if the filter sets should be evaluated with an AND or an OR .PARAMETER Type The condition type: All Logon Window Schedule Keyboard Idle Performance EventLog FileSystem Process Service SNMPTrap WMI Database SharePoint .PARAMETER SortProperty The object property to sort results on. Do not use BPAServer or TypeName, since those are custom properties added by this module, and not exposed in the API. .PARAMETER SortDescending If specified, this will sort the output on the specified SortProperty in descending order. Otherwise, ascending order is assumed. .PARAMETER BPAServer The AutoMate BPA management server. .INPUTS Conditions related to the following objects can be retrieved by this function: Workflow Agent Folder .EXAMPLE Get-BPACondition "My Condition" Get-BPAWorkflow "My Workflow" | Get-BPACondition .EXAMPLE # Get conditions that have "Daily" in the name and are not enabled, using filter sets Get-BPACondition -FilterSet @{ Property = "Name"; Comparator = "contains"; Value = "Daily"},@{ Property = "Enabled"; Comparator = "="; Value = "false"} .NOTES Author(s): : David Seibel Contributor(s) : Date Created : 08/24/2016 Date Modified : 05/03/2018 .LINK https://github.com/davidseibel/PoshBPA #> [CmdletBinding(DefaultParameterSetName = "All")] [OutputType([System.Object[]])] param( [Parameter(ValueFromPipeline = $true, ParameterSetName = "ByPipeline")] [ValidateNotNullOrEmpty()] $InputObject, [Parameter(Position = 0)] [ValidateNotNullOrEmpty()] [string]$Name, [Parameter(ParameterSetName = "ByID")] [ValidateNotNullOrEmpty()] [string]$ID, [Hashtable[]]$FilterSet, [ValidateSet("And","Or")] [string]$FilterSetMode = "And", [ValidateNotNullOrEmpty()] [BPATriggerType]$Type = [BPATriggerType]::All, [ValidateNotNullOrEmpty()] [string[]]$SortProperty = "Name", [switch]$SortDescending = $false, [ValidateNotNullOrEmpty()] [string]$BPAServer ) BEGIN { # If the server is specified, or only 1 server is connected, don't show it. Otherwise, show the server. if ($PSCmdlet.ParameterSetName -eq "ByID" -and (-not $PSBoundParameters.ContainsKey("BPAServer")) -and ($global:BPAConnectionInfo.Count -gt 1)) { throw "When searching by ID: 1) BPAServer must be specified, OR 2) only one server can be connected." } $splat = @{ RestMethod = "Get" BPAServer = $BPAServer } $result = @() $conditionCache = @{} if ($PSBoundParameters.ContainsKey("Name") -and (-not [System.Management.Automation.WildcardPattern]::ContainsWildcardCharacters($Name))) { $FilterSet += @{Property = "Name"; Comparator = "="; Value = [System.Management.Automation.WildcardPattern]::Unescape($Name)} } elseif ($PSBoundParameters.ContainsKey("Name") -and [System.Management.Automation.WildcardPattern]::ContainsWildcardCharacters($Name)) { try { "" -like $Name | Out-Null } # Test wildcard string catch { throw } # Throw error if wildcard invalid $splat += @{ FilterScript = {$_.Name -like $Name} } } if ($Type -ne [BPATriggerType]::All) { $FilterSet += @{Property = "TriggerType"; Comparator = "="; Value = $Type.value__} } } PROCESS { switch($PSCmdlet.ParameterSetName) { "All" { $splat += @{ Resource = Format-BPAUri -Path "conditions/list" -FilterSet $FilterSet -FilterSetMode $FilterSetMode -SortProperty $SortProperty -SortDescending:$SortDescending.ToBool() } $result = Invoke-BPARestMethod @splat } "ByID" { $splat += @{ Resource = "conditions/$ID/get" } $result = Invoke-BPARestMethod @splat } "ByPipeline" { foreach ($obj in $InputObject) { $tempSplat = $splat if (-not $tempSplat.ContainsKey("BPAServer")) { $tempSplat += @{ BPAServer = $obj.BPAServer } } else { $tempSplat["BPAServer"] = $obj.BPAServer } if (-not $conditionCache.ContainsKey($obj.BPAServer)) { Write-Verbose "Caching condition objects for server $($obj.BPAServer) for better performance" $conditionCache.Add($obj.BPAServer, (Get-BPACondition -FilterSet $FilterSet -FilterSetMode $FilterSetMode -SortProperty $SortProperty -SortDescending:$SortDescending.ToBool() -BPAServer $obj.BPAServer)) } switch ($obj.TypeName) { "Workflow" { # Get conditions contained within the provided workflow(s) foreach ($trigger in $obj.Triggers) { switch ($trigger.ConstructType -as [BPAConstructType]) { "Condition" { if ($trigger.ConstructID -ne "") { if ($Type -eq [BPATriggerType]::All) { $result += $conditionCache[$obj.BPAServer] | Where-Object {$_.ID -eq $trigger.ConstructID} } else { $result += $conditionCache[$obj.BPAServer] | Where-Object {$_.ID -eq $trigger.ConstructID -and $_.TriggerType -eq $Type.value__} } } else { Write-Warning "Workflow '$($obj.Name)' contains an unbuilt condition!" } } } } } "Agent" { # Get conditions monitored by the provided agent(s) $tempFilterSet = $FilterSet if ($Type -ne [BPATriggerType]::All) { $tempFilterSet += @{ Property = "TriggerType"; Comparator = "="; Value = $Type.value__ } } $tempSplat += @{ Resource = Format-BPAUri -Path "agents/$($obj.ID)/conditions" -FilterSet $tempFilterSet -FilterSetMode $FilterSetMode -SortProperty $SortProperty -SortDescending:$SortDescending.ToBool() } $result += Invoke-BPARestMethod @tempSplat } "Folder" { # Get conditions contained within the provided folder(s) if ($Type -eq [BPATriggerType]::All) { $result += $conditionCache[$obj.BPAServer] | Where-Object {$_.ParentID -eq $obj.ID} } else { $result += $conditionCache[$obj.BPAServer] | Where-Object {$_.ParentID -eq $obj.ID -and $_.TriggerType -eq $Type.value__} } } default { $unsupportedType = $obj.GetType().FullName if ($_) { $unsupportedType = $_ } elseif (($null -ne $obj.Type) -and ($obj.Type -ne "")) { $unsupportedType = $obj.Type } Write-Error -Message "Unsupported input type '$unsupportedType' encountered!" -TargetObject $obj } } } } } } END { $SortProperty += "BPAServer", "ID" return $result | Sort-Object $SortProperty -Unique -Descending:$SortDescending.ToBool() } } |