Hey everyone,
I wanted to make a post regarding some recent additions to the PowerShell Module that might be beneficial to know about!
With the two latest releases (2.11.0 and 2.12.0) we've introduced a new function, Get-JcScheduledUserstate, as well as some added readability to ourGet-JCSystemInsights function.
I'll start with introducing our latest function, Get-JcScheduledUserstate
Get-JcScheduledUserState
Overview:
Within JumpCloud, you can schedule users to be suspended or activated. You can accomplish this fairly easily from the console, however we wanted to introduce a way for admins to be able to quickly pull a list of upcoming scheduled state changes in their environment. That is where this function comes into play
Function Parameters:
Currently there are only two parameters, -State and -UserID
-State: The user state that you wish to query: ACTIVATED or SUSPENDED
-UserID: You can specify a user's userID to query all upcoming state changes for that one user
Use Examples:
Example 1: Get a list of all upcoming suspensions
Get-JcScheduledUserstate -State Suspended
Example 2: Get a list of all upcoming activations
Get-JcScheduledUserstate - State Activated
Example 3: Get a specific user's upcoming user state changes (gets both suspensions and activations)
Get-JcScheduledUserstate -UserID <USERID>
Output:
id : 6120167a2ad6335b3297b278
Firstname : Ronja
Lastname : Abelsen
Email : ronja.abelsen@example.com
Username : Ronja.Abelsen
State : Suspended
ScheduledDate : 7/5/2024 5:00:00 PM
Note: The ScheduledDate field is converted into your local time
Get-JcSystemInsights
Overview:
The functionality the exactly the same as it was previously but we've added a few calculated fields depending on what -Table you're querying. Previously, the function returned some rather... illegible... values for memory/file sizes. Now you'll be able to see these sizes in GB.
If you'd still like to do some mental math for the conversions on the original fields, don't worry, you are more than welcome to! 😉
Added calculated fields for the Get-JCSystemInsights following tables:
- LogicalDrive - freeSpaceGB, sizeGB
- Mounts - blocksGB, blocksAvailableGB
- systemInfo - physicalMemoryGB
Here's a sample output with the new calculated fields for LogicalDrive lookup:
Get-JCSystemInsights -Table LogicalDrive
BootPartition : 1
CollectionTime : 2024-06-04T09:26:41.200Z
DeviceId : C:
FileSystem : NTFS
FreeSpace : 243366486016
Size : 274112442368
SystemId : 665e0a1197342ad1cb8a3113
Type : Unknown
SizeGB : 255.287
FreeSpaceGB : 226.653
I think that'll do it! Nothing too fancy but something I think that will help anyone out who regularly uses these functions.
