CUT-4112: Userstate Lookups

[gweinjc]

Issues

• CUT-4112 - Userstate Lookups

What does this solve?

Introducing a new function to the JumpCloud PowerShell module called Get-JCScheduledUserstate

This function will allow for admins to see all of their scheduled userstate changes in their org, as well as being able to filter based on scheduled suspensions, activations or even UserIDs

Is there anything particularly tricky?

A single user can have multiple scheduled userstate changes. As an example, a user can be scheduled for suspension at 7/1/2024 as well as being scheduled for activation at 8/1/2024. Looking up the user by their UserID should return both results

How should this be tested?

1. In your admin console, schedule a few users to be suspended as well as a few users to be activated at a later time. Make note of the time of suspension/activation as it should be your local time.
2. To get a list of scheduled user suspensions run the following:

Get-JCScheduledUserstate -State 'SUSPENDED'

3. Validate that this list matches the list of users you scheduled in the admin console
4. To get a list of scheduled user activations run the following:

Get-JCScheduledUserstate -State 'ACTIVATED'

5. Validate that this list matches the list of users you scheduled in the admin console
6. To get a list of a single user's scheduled userstate changes run the following:

Get-JCScheduledUserstate -UserID "UserID"

7. Validate that this list matches the list of users you scheduled in the admin console

[jworkmanjc]

Tested working for me along with multiple users! Approved!

[kmaranionjc]

Tested on my VM, great job on this!

[jworkmanjc]

docs updated, looks good!