CUT-4071: Get-JCSystemKB

[gweinjc]

Issues

• CUT-4071 - Get-JCSystemKB

What does this solve?

This introduces the Get-JCSystemKB function to the PowerShell module. With this function, an admin will be able to search their Windows devices for applied hotfixes/KBs. They will also have the added ability to filter for a specific KB as well as search individual devices

Is there anything particularly tricky?

The only tricky thing was creating the filter. In order to search multiple devices or hotfix_ids, the in operator must be used in the endpoint, however if you're only searching for a single device or hotfix_id, the eq operator must be used.

In order to solve for this I had to use a conditional to check if multiple values were inputted to the param via a comma separated array and then concat them together to form a valid string to be passed to the API

How should this be tested?

1. Pull the branch locally and import the module

Import-Module “/Users/USERNAME/Documents/GitHub/support/PowerShell/JumpCloud Module/JumpCloud.psd1” -force
Connect-JConline APIKEY -force

2. Run the following commands and validate their output

# This should return all KBs in your organization
Get-JCSystemKB

# This should return all KBs for one device
$windowsDevice = Get-JCSystem -OS Windows | Select -First 1
Get-JCSystemKB -SystemID $windowsDevice._id

# This should return all KBs for one device using pipeline
$windowsDevice = Get-JCSystem -OS Windows | Select -First 1
$windowsDevice | Get-JCSystemKB

# This should return all devices that have that specific KB installed
$hotfix = Get-JCSystemKB | Select -First 1
Get-JCSystemKB -KB $hotfix.hotfix_id

# This should return one specific KB for one specific system
$hotfix = Get-JCSystemKB | Select -First 1
Get-JCSystemKB -KB $hotfix.hotfix_id -SystemID $hotfix.system_id

[tonybjc]

Looks good, great comments as well. Thanks Geoff.

[kmaranionjc]

Tests and code looks good. Awesome work here!