Skip to content

Latest commit

 

History

History
1976 lines (1223 loc) · 65.8 KB

ModuleChangelog.md

File metadata and controls

1976 lines (1223 loc) · 65.8 KB

2.17.0

Release Date: January 3, 2025

RELEASE NOTES

This release introduces two new functions `New-JCReport` and `Get-JCReport`

FEATURES:

  • Introduces two new functions New-JCReport and Get-JCReport
    • New-JCReport - Generates a report using the pre-built report generators available in the console
    • Get-JCReport - Allows you get get the report metadata and once the report is finished processing, using the reportID and the artifactID, you can output the report content via JSON or CSV

2.16.0

Release Date: January 02, 2025

RELEASE NOTES

This release introduces support for cascading managers with `Remove-JCUser`
This release introduces a bug fix for `Import-JCUsersFromCSV` and `Update-JCUsersFromCSV` issues with importing more than 10 custom attributes. This release also introduces `Update-JCDeviceFromCSV` and `New-JCDeviceUpdateTemplate` functions.

FEATURES:

  • Introduces the Update-JCDeviceFromCSV and New-JCDeviceUpdateTemplate functions
    • New-JCDeviceUpdateTemplate: Creates a csv template used for bulk updating devices
    • Update-JCDeviceFromCSV: Updates a list of devices from a CSV created by the New-JCDeviceUpdateTemplate function
  • Introduces Remove-JCUser - Added -CascadeManager (null, automatic, user) parameter
    • null - Manager field for managed users by the user being removed will be set to null
    • automatic - If the user (manager1) being removed is a manager but also managed by another user(manager2). The manager for managed users will cascade to manager2.
    • User - Manually specify the manager for users managed by the user/manager being removed
      • -CascadeManagerUser Id/Username

BUG FIXES:

  • Fixed a bug with Import-JCUsersFromCSV and Update-JCUsersFromCSV throwing error when importing 10 or more Custom Attributes due to a sorting issue
  • Fixed a bug with Get-JCSystemApp returning an error when searching for an app that is less than 4 characters long

2.15.0

Release Date: November 18, 2024

RELEASE NOTES

This release adds support for new functions to interact with Policy Groups and Policy Group Templates

FEATURES:

New Functions: Get-JCPolicyGroup Set-JCPolicyGroup Remove-JCPolicyGroup New-JCPolicyGroup Get-JCPolicyGroupMember Get-JCConfiguredTemplatePolicy Get-JCPolicyGroupTemplate Get-JCPolicyGroupTemplateMember Remove-JCPolicyGroupTemplate

IMPROVEMENTS:

Support for future MTP specific functions. The Update/Import-JCUserFromCSV function can now update/import a user's recovery email.

2.14.3

Release Date: November 7, 2024

RELEASE NOTES

Removed 40 character validation for the JumpCloud API key, Add "notes" to the JCPolicy Functions

FEATURES:

  • Notes can be set and added when creating new policies using the Set/New-JCPolicy Functions. Notes are returned when querying Get-JCPolicy

2.14.2

Release Date: October 16, 2024

RELEASE NOTES

Fixed a bug with `Import-JCUsersFromCSV` and `Update-JCUsersFromCSV` where the a user does not get created/updated when there is an empty value on one of the Attribute columns on the CSV

BUG FIXES:

  • Import-JCUsersFromCSV and Update-JCUsersFromCSV are now able to update/create users even when some Attributes column are not filled in

2.14.1

Release Date: October 1, 2024

RELEASE NOTES

Fixed a bug with `Set-JCUser` not having the ability to remove a user's manager by setting it to `$null`

BUG FIXES:

  • Set-JCUser now allows removing a user's manager by inputting a $null value as expected

2.14.0

Release Date: September 25, 2024

RELEASE NOTES

Introduces the `Get-JCSystemKB` Function - This function will allow you to search for applied hotfixes/KBs on your Windows devices across your organization

BUG FIXES:

Fixed a bug where Get-JCPolicy would return multiple templateIDs per policy

FEATURES:

  • Get-JCSystemKB - Returns applied hotfixes/KBs on Windows devices in your organization

2.13.1

Release Date: September 09, 2024

RELEASE NOTES

Renamed -RemoveAtrribute to -RemoveCustomAttribute

2.13.0

Release Date: August 8, 2024

RELEASE NOTES

New admin function, Get-JCAdmin - returns admins in your organization(s)

FEATURES:

  • Get-JCAdmin - Returns administrators in your organization
    • MSP/MTP tenants can query multiple organizations or individual organizations

2.12.1

Release Date: August 08, 2024

RELEASE NOTES

Patch release to include new Pester Tests. No functional changes have been made

IMPROVEMENTS:

Included Pester Test to check for updating documentation

2.12.0

Release Date: July 10, 2024

RELEASE NOTES

Added new calculated fields for Get-JCSystemInsights Tables LogicalDrives, Mounts, and SystemInfo to include human readable sizes in GB for the following fields: PhysicalMemory, blocks, blocksAvailable, freeSpace, and size

IMPROVEMENTS:

  • Added calculated fields for the Get-JCSystemInsights following tables:
    • LogicalDrives - freeSpaceGB, sizeGB
    • Mounts - blocksGB, blocksAvailableGB
    • systemInfo - physicalMemoryGB

2.11.0

Release Date: June 13, 2024

RELEASE NOTES

Introducing a new function Get-JcScheduledUserstate - This will allow for the lookup of upcoming user suspensions/activations

FEATURES:

New Function: Get-JcScheduledUserState - Allows for the lookup of scheduled userstate changes. This will list upcoming suspensions or activations as well as being able to search for a particular user's upcoming state changes by their UserID

2.10.2

Release Date: May 30, 2024

RELEASE NOTES

Fixed a bug when creating a staged user and attempting to enable MFA
Removed the unused `systemToken` property from the Get-JCSystem function

BUG FIXES:

Fixed a bug when creating a staged user and attempting to enable MFA

FEATURES:

Removed the systemToken property from the Get-JCSystem function

2.10.1

Release Date: April 2, 2024

RELEASE NOTES

Added several missing filter fields to Get-JCUser, Get-JCSystem, Get-JCCommand

FEATURES:

Additional returnProperties added to Get-JCUser, Get-JCSystem, Get-JCCommand functions

2.10.0

Release Date: January 17, 2024

RELEASE NOTES

New Directory Functions, Add-JCGsuiteMember, Add-JCOffice365Member, Remove-JCGsuiteMember, and Remove-JCOffice365Member added to the module

FEATURES:

Add-JCGsuiteMember - Add a user or user group to a Gsuite instance Add-JCOffice365Member - Add a user or user group to an Office365 instance Remove-JCGsuiteMember - Remove a user or user group from a Gsuite instance Remove-JCOffice365Member - Remove a user or user group from an Office365 instance

2.9.1

Release Date: January 11, 2024

RELEASE NOTES

This release adds an available field for Get-JCUser to reutn, `systemUsername`.

FEATURES:

NA

IMPROVEMENTS:

SystemUsername has been added to Get-JCUser -returnProperties. ex. Get-JCuser -username defaultadmin -returnProperties systemUsername will return the local systemUsername for a given user.

BUG FIXES:

NA

2.9.0

Release Date: December 5, 2023

RELEASE NOTES

New Directory Functions, Get-JCCloudDirectory, Set-JCCloudDirectory added to the module

FEATURES:

Get-JCCloudDirectory Added, fetch JumpCloud Cloud Directory instances (gsuite, office_365) programmatically Set-JCCloudDirectory Added, update existing JumpCloud Cloud Directory instances (gsuite, office_365) programmatically

2.8.3

Release Date: November 20, 2023

RELEASE NOTES

Addressed the issue with Get-JCPolicyTemplateConfigField select/multi property string error

BUG FIXES:

  • Fixed an issue with Get-JCPolicyTemplateConfigField error when a string select/multi property is passed to an int conversion

Release Date: November 2, 2023

RELEASE NOTES

Addressed the issue with Get-JCPolicyTargetGroup indexing error. Update several module tests to run in parallel.

BUG FIXES:

  • Fixed an issue with Get-JCPolicyTargetGroup index error when a policy group is not bound to a device group

2.8.1

Release Date: October 19, 2023

RELEASE NOTES

Addressed the issue with Get-JCAssociation errors when param Type is sent through dynamic parameter and duplicate key in property hash

BUG FIXES:

  • Fixed an issue with param targetType defaulting when dynamicParam is set
  • Fixed an issue with system associated to a command where duplicate key being added

2.8.0

Release Date: October 16, 2023

RELEASE NOTES

Addressed an issue with Remove-JCSystemGroup and Remove-JCUserGroup, groups can be removed by ID if specified.

BUG FIXES:

Fixed an issue with Remove-JCSystemGroup and Remove-JCUserGroup where group names could not be identified.

2.7.0

Release Date: August 1, 2023

RELEASE NOTES

This release introduces a new parameter, registryFile, to New-JCPolicy and Set-JCPolicy

FEATURES:

Admins can now upload a .reg file to a new or existing Windows - Advanced: Custom Registry Keys Policy

BUG FIXES:

Fixed an issue with sequential results not returning as expected with large datasets

2.5.1

Release Date: May 30, 2023

RELEASE NOTES

Bug fix for Update-JCUsersFromCSV function

BUG FIXES:

Update-JCUsersFromCSV would throw an incorrect status message if updated custom attributes or other API errors would be thrown during script execution. Now the correct error statement from our API should be displayed in the status message object on each updated user.

2.5.0

Release Date: May 11, 2023

RELEASE NOTES

New Policy Function, Remove-JCPolicy added to the module

FEATURES:

Remove-JCPolicy added, remove existing JumpCloud Policies programmatically

2.4.0

Release Date: May 1, 2023

RELEASE NOTES

New Policy Functions, Set-JCpolicy, New-JCPolicy added to the module

FEATURES:

New-JCPolicy Added, create new JumpCloud Policies programmatically Set-JCPolicy Added, update existing JumpCloud Policies programmatically

2.3.0

Release Date: March 20, 2023

RELEASE NOTES

This release improves the functionality of the Add/Remove GroupMember functions and adds a full text query parameter to Get-JCEvent

FEATURES:

  • Get-JCEvent has a new full text query parameter, -Q

IMPROVEMENTS:

  • Replaced Invoke-WebRequest calls in the following functions with SDK functions to improve TTC and remove
    • Add-JCSystemGroupMember
    • Remove-JCSystemGroupMember
    • Add-JCUserGroupMember
    • Remove-JCUserGroupMember

2.2.0

Release Date: February 7, 2023

RELEASE NOTES

This release adds new function Get-JCSystemApp which enables admins to search for 'x' software and 'y' version on specific device, devices in a specific os, or all managed JumpCloud devices.

FEATURES:

  • Get-JCSystemApp command enables search by:
    • applications installed in a specific system
    • applications installed from all the systems specified by OS
    • Software Name and or Version

2.1.3

Release Date: January 5, 2023

RELEASE NOTES

- Restored a missing id field for users and systems

BUG FIXES:

  • Get-JCSystem/ User functions were missing the .id data field on PowerShell versions 7+. This release restores this field. The ._id filed is unaffected but you can choose to reference either $system.id or $system._id.

2.1.2

Release Date: November 30, 2022

RELEASE NOTES

- Fixed an issue with passing pipeline data from Get-JCSystem to Set-JCsystem

BUG FIXES:

  • Set-JCSystem would throw error regarding systemInsights when using data passed via Get-JCSystem pipeline

2.1.1

Release Date: November 22, 2022

RELEASE NOTES

- Fixed an issue with Get-JCObject

BUG FIXES:

  • Removed an incorrect unicode character that was causing a failure with Importing the module, specifically with the Get-JCObject function

2.1.0

Release Date: November 9, 2022

RELEASE NOTES

- This release adds description field parameter to Set-JCSystem and search by description to Get-JCSystem

FEATURES:

Get/Set-JCSystem support for description field

IMPROVEMENTS:

  • Description parameter added to Get and Set-JCSystem
  • Added -Force switch parameter that populates New-JCImportTemplate with all headers when user update or new user CSV is created
  • Additional reporting added to Backup-JCOrganization. If failed tasks are detected, the status of the function should report which tasks failed
  • Get-JCSystem -filterDateProperty lastContact will now return active systems

BUG FIXES:

  • Bug fix for Set-JCCommand where commandType, launchType, and timeout gets changed to default values
  • Bug fix for Get-JCObject where some endpoints(radius_server, cloud directory) output incorrect values
  • Bug fix for Get-JCRadiusServer/ Set-JCRadiusServer where authID was being reset

2.0.1

Release Date: September 1, 2022

RELEASE NOTES

This release introduces Parallel processing functionality to several functions (Get-JCUser, Get-JCSystem, Get-JCSystemUser, Get-JCGroup, Get-JCSystemGroupMember, Get-JCUserGroupMember, Get-JCCommand, Get-JCCommandResult, Get-JCCommandTarget)

Note: In order to use the parallel functionality, the feature requires PowerShell version 7 or higher

FEATURES:

  • This release adds parallel processing functionality to potentially alleviate long wait times for large scale operations
    • Note: Feature requires PowerShell version 7 or higher
    • This release adds parallel processing to the following functions:
      • Get-JCUser
      • Get-JCSystem
      • Get-JCSystemUser
      • Get-JCGroup
      • Get-JCSystemGroupMember
      • Get-JCUserGroupMember
      • Get-JCCommand
      • Get-JCCommandResult
      • Get-JCCommandTarget
  • Added -ByCommandID and -CommandID to Get-JCCommandResult
    • The added functionality will allow admins to search for all command results pertaining to a single command via the commandID or the workflowID
    • When using the pipeline for inputting a command object to Get-JCCommandResult, use the -ByCommandID switch
      • Example: $OrgCommandResults = Get-JCCommand | Get-JCCommandResult -ByCommandID ... This will get all command results for commands that match the pipeline input
      • Example: Get-JCCommandResult -CommandID 63091abcfe6657f38768ce12 ... This will return commandResults on systems from the command with ID 63091abcfe6657f38768ce12
    • Changed the way command results return all information.
      • Instead of running 'Get-JCCommandResult | Get-JCCommandResult -ById' to get full details of a command result. Simply run 'Get-JCCommandResult -Detailed'
      • Example: $OrgCommandResults = Get-JCCommandResult -detailed
  • Case Insensitive Search added to Get-JCUser, Get-JCSystem, Get-JCCommand
    • User, System, Command attributes can be searched without case sensitivity
      • Example: Get-JCUser -username 'defaultadmin' ... This will return the user with username 'DefaultAdmin'
      • Example: Get-JCSystem -displayname 'mac-jimmys-macbook' ... This will return the system with displayname 'Mac-Jimmys-MacBook'
      • Example: Get-JCCommand -command "disable" ... This will return commands with some variation of the word 'Command/command' in the command body

IMPROVEMENTS:

  • Adjusted output for Get-JCSystemGroupMember -ByID and Get-JCUserGroupMember -ByID to match the output of -GroupName
  • Removed individual hash functions in favor for dynamic hash function
    • Replaced all references to old functions
  • Added case-insensitivity to search endpoints Get-JCUser, Get-JCSystem, and Get-JCCommand Example: command name 'List Users' = 'list users' or hostname 'thisPc' = 'ThisPC'

BUG FIXES:

N/A

1.23.4

Release Date: July 25, 2022

RELEASE NOTES

This release modifies New-JCCommandURL to convert Import-JCCommand url to raw github content to prevent changes to GitHub HTML from breaking Import-JCCommand function

1.23.3

Release Date: July 20, 2022

RELEASE NOTES

This release modifies how the Manager Username Lookup works with Get-JCUser. Only usernames/ emails that match the full string of the search are now returned. In addition users set with Set-JCUser will correctly modify managers by email address.

BUG FIXES:

  • Get-JCUser -Manager "someUser" could return multiple values if another user username: "User" exists in the Organization
  • Set-JCUser -Username "theUser" -Manager "someUser" could return multiple values if another user username: "User" exists in the Organization

1.23.2

Release Date: July 11, 2022

RELEASE NOTES

This release modifies how the Manager Username Lookup works with Get-JCUser. Only usernames/ emails that match the full string of the search are now returned

BUG FIXES:

  • Get-JCUser -Manager "someUser" could return multiple values if another user username: "User" exists in the Organization

1.23.1

Release Date: July 7, 2022

RELEASE NOTES

This release adds validate to the Get-JCUser -State parameter set. It should now validate supplied acceptable values. Documentation for Get-JCCommand updated thanks to JumpCloud Community member: Ryan Bailey @rybai

1.23.0

Release Date: June 21, 2022

RELEASE NOTES

This release adds search endpoint functionality and new parameters to Get-JCCommand

BUG FIXES:

  • N/A

1.22.1

Release Date: May 19, 2022

RELEASE NOTES

This release includes a bug-fix for read only API Keys and running Backup-JCOrganization

BUG FIXES:

  • Backup-JCOrganization no longer throws a forbidden error message when run with a read-only API Key. In the previous release, we solved for only a subset of Backup-JCOrganizations' Read-Only error messages, these should now be resolved.

1.22.0

Release Date: May 16, 2022

RELEASE NOTES

This release includes an update to Set, Get, New-JCUser to search manager by a valid JumpCloud user's primary email

IMPROVEMENTS:

  • Set, Get, New-JCUser will validate email address value given to -manager

FEATURES:

  • This release adds email search to manager field in Set, Get, New-JCUser
  • This release adds new parameters to Get-JCResults private function

BUG FIXES:

  • Backup-JCOrganization no longer throws a forbidden error message when run with a read-only API Key.

1.21.0

Release Date: May 11, 2022

RELEASE NOTES

This release includes an update to Update-JCModule intended to help updating future fersions of the PowerShell SDK

IMPROVEMENTS:

  • Update-JCModule specifically targets which version of the new SDK to install and uninstall.

FEATURES:

  • This release adds the -recoveryemail parameter to Set, Get, New-JCUser

BUG FIXES:

N/A

1.20.1

Release Date: April 28, 2022

RELEASE NOTES

This releasse includes a patch to fix pagination where a null system record exists in Get-JCSystemGroupMember.

IMPROVEMENTS:

  • Import/Update-JCUsersFromCSV will validate that custom attribute values are not null before attempting to Import/Update users.
  • Addressed an issue with Update-JCModule failing if GitHub or PowerShellGallery were inaccessible

BUG FIXES:

1.20.0

Release Date: March 31, 2022

RELEASE NOTES

This release incorporates the "state" parameter into Get/Set/New-JCUser

FEATURES:

state parameter added to module see Managing User State documentation.

IMPROVEMENTS:

  • Import/Update-JCUsersFromCSV will validate that custom attribute values are not null before attempting to Import/Update users.

BUG FIXES:

N/A

1.19.0

Release Date: March 7, 2022

RELEASE NOTES

This release incorperates the "alternateEmail", "manager" and "managedAppleID" files in both Get/Set/New-JCUser & the CSV Import Functions (Import-JCUsersFromCSV, Update-JCUsersFromCSV, New-JCImportTemplate)

FEATURES:

alternateEmail, manager, managedAppleID attributes added to module

SDKs should prompt to update on Connect-JConline

IMPROVEMENTS:

Organization Settings are saved on Connect-JCOnline CI updates to incorporate changes to SDK generation

Bug Fixes:

Documentation updated for Set-JCRadiusReplyAttributes: 0 is not an allowed value for VLAN ID Fixed a bug which prevented system/user attributes with "sudo attributes" from being copied to another system/user with the Copy-JCAssociation function When releasing the PowerShell Module to the main branch the CI process will automatically draft a release with the release notes for that release version from the module changelog file.

1.18.12

Release Date: December 17, 2021

RELEASE NOTES

This release reverts a change to the Update-JCModule function which displayed erroneous error messages and includes a roll up bug fixes from the 1.18.9 release. This release includes an updated nuspec file to require the PowerShell SDKs

BUG FIXES:

SA-2296 - Require the SDKs in the generated Nuspec file before creating module

1.18.11

Release Date: December 16, 2021

RELEASE NOTES

This release reverts a change to the Update-JCModule function which displayed erroneous error messages and includes a roll up bug fixes from the 1.18.9 release.

BUG FIXES:

SA-2258 - Fix Set-JCUser function where it would error when setting a user's enrollment windows anywhere between 4-7 days.

SA-2271 - Fix the Regex Pattern used in Import-JCCommand to address change in GitHub.

1.18.10

Release Date: December 5, 2021

RELEASE NOTES

This release includes a fix for Update-JCModule to account for systems with an older version of the PowerShellGet module.

BUG FIXES:

SA-2273 - Fixes an error on systems where the PowerShellGet module could not support "AllowPreRelease" parameters

1.18.9

Release Date: December 3, 2021

RELEASE NOTES

This release contains a fix for the Set-JCUser function where the MFA enrollment parameter wouldn't set correctly. A fix for Impport-JCCommand failing to import commands was also identified and fixed in this release.

BUG FIXES:

SA-2258 - Fix Set-JCUser function where it would error when setting a user's enrollment windows anywhere between 4-7 days.

SA-2271 - Fix the Regex Pattern used in Import-JCCommand to address change in GitHub.

IMPROVEMENTS:

Add CodeArtifact support to Update-JCModule Enable the PowerShell Module to be tested from latest development versions of the PowerShell SDKs

1.18.8

Release Date: October 12, 2021

RELEASE NOTES

Patch release to address missing unix_uid field in Import/Update-JCUserFromCSV functions

FEATURES:

Users unix UID/GUID can now be set from the Import/Update-JCUserFromCSV functions

1.18.7

Release Date: September 30, 2021

RELEASE NOTES

Patch release to address bug with Copy-JCAssociations

BUG FIXES:

Bug Fix: SA-2083 Copy Associations with attributes not working as expected. Copy-JCAssociations should now copy associations with attributes and not error

1.18.6

Release Date: September 03, 2021

RELEASE NOTES

* Updated the help docs for Get-JCSystemInsights

1.18.5

Release Date: June 23, 2021

RELEASE NOTES

  • switch to circleci pipeline
  • Update tsts with valid radius reply attributes

1.18.4

Release Date: May 03, 2021

RELEASE NOTES

  • Invoke-JCDeployment updated to use SDK versions of the PowerShell Module

FEATURES

IMPROVEMENTS

BUG FIXES

  • Invoke-JCDeployment will no longer reset a command type to linux when run

1.18.3

Release Date: January 04, 2021

RELEASE NOTES

FEATURES

  • Backup-JCOrganization can be used to backup your JumpCloud organization to local json files

IMPROVEMENTS

  • Misc internal improvements.
  • User agent has been updated to accommodate for JcSlackBot tracking.

BUG FIXES

1.18.2

Release Date: September 3, 2020

RELEASE NOTES

The *-Association functions now call functions from the JumpCloud.SDK.V2 instead of custom Invoke-WebRequest calls.

FEATURES:

IMPROVEMENTS:

The *-Association functions now call functions from the JumpCloud.SDK.V2 instead of custom Invoke-WebRequest calls. The functions no longer return objects with IsSuccessStatusCode and Error properties.

BUG FIXES:

1.18.1

Release Date: August 14, 2020

RELEASE NOTES

  • Get-JCUser and Get-JCSystem updated to accept dates as a datetime type.
    • Prevents "String not recognized as valid datetime" error in other non en-US regions

FEATURES:

IMPROVEMENTS:

Testing the JumpCloud PowerShell module and dependent JumpCloud.SDK.* modules with private repositories is supported.

BUG FIXES:

Dates in Get-JCuser and Get-JCSystem are now passed in as datetime types which prevents localization conversion errors

1.18.0

Release Date: August 13, 2020

RELEASE NOTES

  • Get-JCSystemInsights has been updated to use the JumpCloud.SDK.V2 powershell module.
    • Feature Enhancements
      • New SystemInsights tables will be automatically added they become available.
      • By using tab complete on the -Filter parameter an example of how to build the filter will be populated.
    • Breaking Changes
      • Table names no longer contain special characters. ex: _, -
      • Returned object properties no longer contain special characters. ex: _, -
      • Table names are singular instead of plural.
      • Dropping the -Name parameter to increase performance.

FEATURES

Get-JCEvent and Get-JCEventCount functions now work with MTP API Keys. Get-JCSystemInsights tables are pulled automatically from JumpCloud.SDK.V2 module. Remove depreciated SystemInsights WindowsCrashes table.

IMPROVEMENTS

BUG FIXES

1.17.5

Release Date: July 20, 2020

RELEASE NOTES

Use Get-JCSystemInsight to query additional System Insights tables.

FEATURES

Updated Get-JCEvent. New function Get-JCEventCount. Remove Depreciated SystemInsights Registry Table.

IMPROVEMENTS

BUG FIXES

Fix for windows PowerShell Update-JCModule function. Fix for pipeline to specify manual version of module

1.17.3

Release Date: June 25, 2020

RELEASE NOTES

Use Get-JCSystemInsight to query additional System Insights tables.

FEATURES

Query new SystemInsights tables: alf_exceptions, alf_explicit_auths, appcompat_shims, authorized_keys, connectivity, dns_resolvers, wifi_networks, wifi_status, and windows_security_products

IMPROVEMENTS

Allow for Get-JCPolicy parameters $PolicyID and $Name to take multiple strings

Clean up of tls settings

BUG FIXES

Add retry values to resolving 500 errors

1.17.2

Release Date: May 18, 2020

RELEASE NOTES

Bug fix PowerShell 5.1 users launching Connect-JCOnline

FEATURES

IMPROVEMENTS

BUG FIXES

String Concatenation syntax fix for Update-JCModule

1.17.1

Release Date: May 04, 2020

RELEASE NOTES

Bug fix for when user calls: Get-Help -online Get-JCEvent

FEATURES

IMPROVEMENTS

BUG FIXES

Help link fix for Get-JCEvent

1.17.0

RELEASE DATE

April 30, 2020

RELEASE NOTES

Minor changes to make the auto-update functionality more robust.

Use Get-JCEvent to query JumpCloud event logs.

FEATURES

IMPROVEMENTS

New functions: Get-JCEvent

Auto-update now utilizes metadata from the PowerShell Gallery to determine when an update is available

BUG FIXES

1.16.0

RELEASE DATE

March 30, 2020

RELEASE NOTES

Use Get-JCSystemInsight to query additional System Insights tables including interface_details

FEATURES

Query new SystemInsights tables: certificates, cups_destinations, interface_details, python_packages, registry, scheduled_tasks, services and startup_items

IMPROVEMENTS

BUG FIXES

Resolved issue with Invoke-JCCommand when calling commands without variables

1.15.5

RELEASE DATE

March 25, 2020

RELEASE NOTES

Need to update users email addresses in bulk? You can now do that using New-JCImportTemplate and Update-JCUsersFromCSV

Features

IMPROVEMENTS

BUG FIXES

Resolved issue that caused module to attempt to update when running the latest version

1.15.4

RELEASE DATE

February 19, 2020

RELEASE NOTES

Need to update users email addresses in bulk? You can now do that using New-JCImportTemplate and Update-JCUsersFromCSV

FEATURES

Ability to add email column to output of New-JCImportTemplate when updating users

IMPROVEMENTS

BUG FIXES

Resolved issue that could cause issues with regional DateTime formats

1.15.3

RELEASE DATE

January 9, 2020

RELEASE NOTES

You can now update all attributes of a RADIUS server using Set-JCRadiusServer. New parameters added to Get-JCSystem and Get-JCUser.

FEATURES

Set-JCRadiusServer can now update userPasswordExpirationAction, userLockoutAction, and mfa Get-JCUser now can return the mfa property using -returnProperties Get-JCSystem can now search for macOS machines with the JumpCloud Service Account using the -hasServiceAccount parameter Get-JCSystem can now return the hasServiceAccount, fileSystem properties using -returnProperties

IMPROVEMENTS

BUG FIXES

1.15.2

RELEASE DATE

December 19, 2019

RELEASE NOTES

Support for UTF-8 encoding and new SystemInsights tables available and ability to filter systems on lastContact date.

FEATURES

Get-JCSystem -filterDateProperty parameter now accepts lastContact in addition to created.

New SystemInsights tables available:

  • alf
  • battery
  • crashes
  • ie_extensions
  • launchd
  • logged_in_users
  • managed_policies
  • shadow
  • shared_folders
  • shared_resources
  • sharing_preferences
  • sip_config
  • usb_devices
  • user_groups
  • user_ssh_keys

IMPROVEMENTS

Support for UTF-8 encoding.

BUG FIXES

1.15.1

RELEASE DATE

October 22, 2019

RELEASE NOTES

Bug fixes to underlying functions preventing default values for skip, limit, and paginate to be populated.

FEATURES

IMPROVEMENTS

Improved performance of Get-JCBackup command.

BUG FIXES

The function which sets the default values for dynamic parameters was incorrectly filtering parameter sets for dynamic parameters that were passed in causing some parameters default values not to be established.

1.15.0

RELEASE DATE

October 08, 2019

RELEASE NOTES

Addressing bugs impacting associations functions.

FEATURES

IMPROVEMENTS

New functions: Copy-JCAssociation Removing script block used debugging and simplifying with function. Allow Get-JCBackup to take pipeline input. Update Get-JCBackup to use newer functions.

BUG FIXES

When piping to a _-JCAssociations function there was a variable scoping issue that incorrectly set the skip and limit values. When running a _-JCAssociations function JC types with only one target type were not correctly being populated due to an unnecessary validation step.

1.14.0

RELEASE DATE

September 12, 2019

RELEASE NOTES

Functions to interact with JumpCloud Radius Servers are now available
!!!*****************************************
!!!IF YOU RECEIVE AN ERROR WHILE UPDATING THE MODULE PLEASE RUN:
Install-Module JumpCloud -force
!!!*****************************************

FEATURES

New functions:

  • Get-JCRadiusServer
  • Remove-JCRadiusServer
  • New-JCRadiusServer
  • Set-JCRadiusServer

IMPROVEMENTS

Updated logic for Connect-JCOnline. Improved module welcome page. Changes for SystemInsights moving out of EA.

BUG FIXES

1.13.3

RELEASE DATE

September 04, 2019

RELEASE NOTES

Systeminsights improvements.
*****************************************
IF YOU RECEIVE AN ERROR WHILE UPDATING THE MODULE PLEASE RUN:
Install-Module JumpCloud -force
*****************************************

FEATURES

IMPROVEMENTS

  • Additional systeminsights tables have been added: etc_hosts, logical_drives, disk_info, bitlocker_info, patches, programs
  • Systeminsights id property has been renamed from jc_system_id to system_id.

BUG FIXES

1.13.2

RELEASE DATE

August 19, 2019

RELEASE NOTES

Bug fixes for connecting to a JumpCloud organization with no name specified.
Bug fix for functions that call Connect-JCOnline to set an API key if key is not set.
Formatting update for Connect-JCOnline output.

FEATURES

IMPROVEMENTS

  • Updated Function: Connect-JCOnline with output information formatting updates.
  • Moved parameter help messages from help files to functions to assist with dynamic building of documentation.

BUG FIXES

  • Updated Function: Connect-JCOnline to return function output if called within the begin block of a function.
  • Updated functions to call Connect-JCOnline to set API key if key is not set.

1.13.1

RELEASE DATE

August 8, 2019

RELEASE NOTES

Bug fixes for MTP admins that manage a large amount of orgs.
New parameter "-SystemFDEKey" on Get-JCSystem to backup SystemFDEKeys.
Enable SystemInsights for systems using new boolean parameter "-systemInsights" and Set-JCSystem.

FEATURES

  • Updated Function: Get-JCSystem with "-SystemFDEKey" parameter to return the SystemFDEKey for JumpCloud enabled encrypted systems when a system is searched for by JumpCloud SystemID.

  • Updated Function: Set-JCSystem with boolean parameter "-systemInsights" to enable or disable SystemInsights reporting for systems for EA enabled orgs.

  • New Function: Update-JCModule allows the user to check and see if a module update is available and will return release notes.

IMPROVEMENTS

  • Updated Function: Connect-JCOnline with new logic an UI for display release notes and improved module auto update logic.

BUG FIXES

  • Updated Function: Set-JCOrganization to allow admins to successfully connect to for MTP admins that manage 10+ organizations have been resolved.

1.13.0

RELEASE DATE

July 16, 2019

RELEASE NOTES

Changes for automating build and testing of module.
New function Get-JCSystemInsights.
Updated Function: Get-JCSystem with new parameter "-SystemFDEKey"
to return the SystemFDEKey.

FEATURES

  • New Function: Use Get-JCSystemInsights to leverage the new EA system insights API endpoints. These endpoints allow admins to query additional system details for systems that are enabled for System Insights. Find more information about System Insights here
  • Updated Function: Get-JCSystem to allow for revealing the FileVault or BitLocker key. Use the "Switch" parameter "-SystemFDEKey" to display this key from the PowerShell terminal.
  • Updated Function: Get-JCSystem "-returnProperties" parameter set to include "fde" and "systemInsights".

IMPROVEMENTS

Remove dynamic validate set functionality for -Id and -Name parameters due to performance issues. Updated test files to contain code within the describe blocks. Renamed private function files to match the same name of the function within. New Get-JCCommonParameters function.

BUG FIXES

N/A

1.12.1

RELEASE DATE

June 17, 2019

Bug fixes for association functions.

FEATURES

IMPROVEMENTS

BUG FIXES

Resolved issue where association types would return incorrect order. Removed Windows dependency for IE by adding -UseBasicParsing to Invoke-Webrequest.

1.12.0

RELEASE DATE

June 6, 2019

Use Add-JCAssociation and Remove-JCAssociation to modify associations between objects in JumpCloud.
Get-JCAssociation can be piped into Add-JCAssociation or Remove-JCAssociation to make modifications at scale.
User/systems, systems/commands, user_group/applications...etc

FEATURES

  • New-Function: Add-JCAssociation leverages the V2 associations endpoint to add direct associations between an input object and any of it's possible JumpCloud objects associations.
  • New-Function: Remove-JCAssociation leverages the V2 associations endpoint to remove direct associations between an input object and any of it's possible JumpCloud objects associations.

IMPROVEMENTS

Added increased functionality to PowerShell user_agent. Added new attributes "external_dn" and "external_source_type" for managing ADB users to the Set-JCUser and Get-JCUser functions.

BUG FIXES

Fixed bug on Get-JCGroup to return an error if a group is searched for by name and it does not exist.

1.11.0

RELEASE DATE

May 8, 2019

Use Get-JCAssociation to query associations between objects in JumpCloud.
Report on the associations between any two objects.
User/systems, systems/commands, user_group/applications...etc
All available now directly from the Pwsh terminal!
  • New Function: Get-JCAssociation leverages the V2 associations endpoint to return the associations between an input object and any of it's possible JumpCloud objects associations. See How To Use The Associations Functions for more information.

IMPROVEMENTS

Added private functions to standardize API calls to policy endpoints. Updated test file structure and methodology.

1.10.2

RELEASE DATE

April 29, 2019

RELEASE NOTES

Update Set-JCUser to not allow null values for nested properties

BUG FIXES

  • Resolves an issue that would set null values when using Set-JCUser to update the nested "addresses" property.

1.10.1

RELEASE DATE

February 19, 2019

RELEASE NOTES

Update New-JCUser and Set-JCUser to interact with the property mfa instead of the mfaData property when using the parameter enable_user_portal_multifactor to enable mfa for a user.

IMPROVEMENTS

  • This change aligns with recent work done to improve the mfa workflow for JumpCloud end users.

1.10.0

RELEASE DATE

January 21, 2019

RELEASE NOTES

Use Get-JCPolicy, Get-JCPolicyResults, Get-JCPolicyTargetSystem and Get-JCPolicyTargetGroup to gather information on JumpCloud policies. New-JCUser and Set-JCUser functions have been updated to support MFA enrollment periods. Bug fix on Radius Reply Attributes functions for LDAP and Unix groups.

FEATURES

  • New Function: Get-JCPolicy will return policies configured within the JumpCloud admin console.
  • New Function: Get-JCPolicyResults will return policy results for a given PolicyName or PolicyID.
  • New Function: Get-JCPolicyTargetSystem will return associated systems with a given PolicyName or PolicyID.
  • New Function: Get-JCPolicyTargetGroup will return associated groups with a given PolicyName or PolicyID.
  • Updated Function: New-JCUser to set a default enrollment peroid of 7 days for users that are created with '-enable_user_portal_multifactor' set to $true. If this value is set to $true the dynamic parameter -enrollmentDays can also be specified from 1 to 365.
  • Updated Function: Set-JCUser to set a default enrollment peroid of 7 days for users that are updated with '-enable_user_portal_multifactor' set to $true. If this value is set to $true the dynamic parameter -enrollmentDays can also be specified from 1 to 365.

IMPROVEMENTS

Increased -limit value when querying users and system users from 100 to 1000 Increased performance of private Get-Hash_ID_Sudo function.

BUG FIXES

Fixed bug on Remove-JCUser command when trying to remove users by -UserID Fixed bug on RADIUS functions that prevented the addition or removal of Attributes on JumpCloud user groups configured for LDAP or set up as Linux groups Fixed bug in Import-JCUsersFromCSV and Update-JCUsersFromCSV where a null value for employeeIdentifier would report as duplicate

1.9.0

RELEASE DATE

November 29, 2018

RELEASE NOTES

Drastically increase the security of your networks using VLANs and RADIUS VLAN tagging!
Use the new RADIUS reply attribute functions to authenticate and authorize users to VLANs using JumpCloud RADIUS.
Add RADIUS reply attributes to JumpCloud user groups associated with RADIUS servers and implement dynamic per-user VLAN tagging on your network today.
New functions:
Add-JCRadiusReplyAttribute
Get-JCRadiusReplyAttribute
Set-JCRadiusReplyAttribute
Remove-JCRadiusReplyAttribute

FEATURES

RADIUS reply attributes can now be configured on JumpCloud user groups using functions in the JumpCloud PowerShell module. When applied, these attributes will be returned in the Access-Accept message of a RADIUS request. Reply attributes are specified on JumpCloud user groups. Attributes can be applied across multiple users and RADIUS servers through the association of JumpCloud users to JumpCloud user groups and then the association of these JumpCloud user groups to RADIUS servers.

Any RADIUS reply attributes configured on a JumpCloud user group which associates a user to a RADIUS server will be returned in the Access-Accept message sent to the endpoint configured to authenticate with JumpCloud Radius. If a user is a member of more then one JumpCloud user group associated with a given RADIUS server all Reply attributes for the groups that associate the user to the RADIUS server will be returned in the Access-Accept message.

If a user is a member of more then one JumpCloud user group associated with a given RADIUS server and these groups are configured with conflicting RADIUS reply attributes then the values of the attributes for the group that was created most recently will be returned in the Access-Accept message.

RADIUS reply attribute conflicts are resolved based on the creation date of the user group where groups that are created more recently take precedent over older groups. Conflicts occur when groups are configured with the same RADIUS reply attributes and have conflicting attribute values. RADIUS reply attributes with the same attribute names but different tag values do not create conflicts.

  • New Function: Add-JCRadiusReplyAttribute Adds Radius reply attributes to a JumpCloud user group.
  • New Function: Get-JCRadiusReplyAttribute Returns the Radius reply attributes associated with a JumpCloud user group.
  • New Function: Set-JCRadiusReplyAttribute Updates or adds Radius reply attributes to a JumpCloud user group.
  • New Function: Remove-JCRadiusReplyAttribute Removes Radius reply attributes from a JumpCloud user group.

1.8.3

RELEASE DATE

November 6, 2018

RELEASE NOTES

Bug fix for Get-JCGroup to display all group attributes.
Added functionality for JumpCloud internal developers to connect to staging and test environments using the module.

IMPROVEMENTS

  • Updated Function: Connect-JCOnline has new parameter '-JCEnvironment' which JumpCloud developers can use to connect to staging and local test environments.
  • Updated Function: Connect-JCOnline has new parameter '-UserAgent' which JumpCloud developers can use to set their UserAgent when using the module.

BUG FIXES

  • Resolved bug on Get-JCGroup where all group attributes would not display.

1.8.2

RELEASE DATE

October 12, 2018

RELEASE NOTES

Bug fix for Get-JCCommandResult -limit parameter
Increased stability for multi-tenant admins
Check our full release notes to see new attribute additions released in 1.8.0

IMPROVEMENTS

  • Increased stability for multi-tenant admins

BUG FIXES

  • Resolved bug on Get-JCCommandResult where the limit of value of 1000 would cause an error. Default limit value updated to 100.

1.8.1

RELEASE DATE

September 21, 2018

RELEASE NOTES

Bug fix for Multi-Tenant orgs
Check our full release notes to see new attribute additions released in 1.8.0

BUG FIXES

  • Resolved bug on Connect-JCOnline where JumpCloudOrgID would not set correctly

1.8.0

RELEASE DATE

September 20, 2018

RELEASE NOTES

New LDAP user attribute support has been added!
New LDAP user location, information, and telephony attributes.
New function Update-JCUsersFromCSV to add or update all attributes including new LDAP attributes on your existing users.
New function Update-JCUsersFromCSV to add users to groups or bind them to systems in bulk from a CSV file.
Use the updated New-JCImportTemplate function to create a custom user update import CSV file pre-populated with your JumpCloud users to plug into Update-JCUsersFromCSV.
Search for users by LDAP information attributes using Get-JCUser.
Import-JCUsersFromCSV workflow has been updated to handle new attributes.

FEATURES

New LDAP extended user attributes: middlename, preferredName, jobTitle, employeeIdentifier (must be unique), department, costCenter, company, employeeType, description, location New LDAP telephony attributes: mobile_number, home_number, work_number, work_mobile_number, work_fax_number New LDAP location attributes: home_streetAddress, home_poBox home_city, home_state, home_postalCode, home_country, work_streetAddress, work_poBox, work_locality, work_region, work_postalCode, work_country

See how to update users in bulk using these new functions in this KB article

  • New Function: Update-JCUsersFromCSV to add or update all attributes including new LDAP attributes on your existing user , add users to groups, or bind them to systems in bulk from a CSV file.
  • Updated Function: New-JCImportTemplate can now create custom user update CSV import files pre-populated with your JumpCloud users to plug into the new Update-JCUsersFromCSV
  • Updated Function: New-JCUser has parameters for creating users with the new LDAP extended, telephony, and location attributes.
  • Updated Function: Set-JCUser has parameters for updating a modifying users LDAP extended, telephony, and location attributes.
  • Updated Function: Get-JCUser has the ability to search for a filter users based on extended LDAP users.
  • Updated Function: New-JCImportTemplate workflow has been updated to prompt users with options to add the new LDAP extended, telephony, and location attributes to their CSV import templates.
  • Updated Function: Import-JCUsersFromCSV will verify and error check the unique field employeeIdentifier. The output for Import-JCUsersfromCSV has also been cleaned up.

IMPROVEMENTS

  • Updated parameters on Set-JCSystem to allow for modification of parameters via PowerShell pipeline.
  • Removed 20 character limit on JumpCloud username field.
  • Removed method which forced JumpCloud usernames to be lowercase.
  • Updated New-JCImportTemplate to make CSV import file in current working directory.
  • Updated Import-JCCommand to call Connect-JCOnline and set TLS to 1.2.
  • Updated Function: Import-JCUsersFromCSV to use splatting which allows for CSV to contain columns with non JumpCloud user information
  • Progress bars on Import-JCUsersFromCSV and Update-JCUsersFromCSV

1.7.0

RELEASE DATE

August 14, 2018

RELEASE NOTES

Take JumpCloud commands to the next level with Command Deployments!
New functions New-JCDeploymentTemplate and Invoke-JCDeployment.
Deployments are designed for automation scenarios where a 1:1 association between the command payload and JumpCloud system is required.
Use system specific payloads in your JumpCloud commands with variables populated from a CSV file.

FEATURES

  • New Function: New-JCDeploymentTemplate used to create a deployment CSV template file that maps to the corresponding JumpCloud command variables to CSV columns.
  • New Function: Invoke-JCDeployment for calling the command deployment and feeding the command the '-CommandID' of the target JumpCloud deploy command and the populated deployment CSV file.
  • New Function: Set-JCCommand to update JumpCloud commands programmatically. This command is used by the Invoke-JCDeployment command to update the '-launchType' to trigger and trigger the command.

IMPROVEMENTS

  • Warning action "Inquire" removed from Import-JCUsersFromCSV command. Resolves repetitive "Press Y to continue" message during user validation.
  • Streamlined JumpCloud banners. Because less is more.

BUG FIXES

  • Resolved bug on 'Import-JCUserFromCSV' where output for users that were not created due to duplicate username or email would show previously created user information.
  • Resolved bug on 'Import-JCUserFromCSV' where output for users that were not created would show 'User created'.

1.6.0

RELEASE DATE

August 3, 2018

RELEASE NOTES

Send activation/password reset emails with the new function Send-JCPasswordReset
Multi tenant support has been added!
Multi tenant admins will be asked to select the org they want to connect to during API authentication.
Multi tenant admins can switch the org they are connected to using the Set-JCOrganization command.

FEATURES

  • New Function: Send-JCPasswordReset allows admins to use the 'Resend email' button functionality programmatically to send reset/activation emails to targeted users.
  • New Function: Set-JCOrganization allows multi tenant admins to change the JumpCloud tenant they are conneted to.
  • New Function: Get-JCOrganization allows multi tenant admins to see the JumpCloud tenants they have access to.
  • Updated Function: Connect-JCOnline to prompt multi tenant admins to select their connected tenant. Admins can also skip this prompt by entering a 'JumpCloudOrgID' into the new '-JumpCloudOrgID' parameter to setup connection in automation scenarios.

IMPROVEMENTS

  • All Public functions have been updated to include the x-org-id header when a multi tenant API connection is established.

1.5.0

RELEASE DATE

July 16, 2018

RELEASE NOTES

New Function: Get-JCBackup to backup user, system user, system, group information to CSV.
Updated Function: Get-JCCommandResult to show SystemID

FEATURES

  • New Function: Get-JCBackup to backup user, system user, system, user group, and system group information to CSV
  • Updated Function: Get-JCCommandResult to show SystemID when querying command results in bulk and '-ByID'

IMPROVEMENTS

  • Module structure updated. .PSM1 function monolithic broken out into single function .PS1 files in Public and Private folders. This allows for easier debugging and updating of the functions within the module.

1.4.2

RELEASE DATE

May 31, 2018

RELEASE NOTES

Updated Function: Get-JCCommandResult with new parameter '-MaxResult'
Using the parameter '-Skip' and '-MaxResult' admins can return a specific subset of command results.
Performance fix for 'Get-JCCommandResult' with increase default limit to 1000

FEATURES

  • Updated Function: Get-JCCommandResult with new parameters '-MaxResult'. '-MaxResult' can be combinded with '-Skip' to return a specific subset of command results.

IMPROVEMENTS

  • Updated Function: Get-JCCommandResult speed and performance by removing sort.
  • Updated Function: Get-JCCommandResult increased default limit to 1000 results.

1.4.1

RELEASE DATE

May 25, 2018

RELEASE NOTES

Updated Function: Get-JCCommandResult with new parameters '-TotalCount' and '-Skip'
'-TotalCount' returns the number of command results
'-Skip' returns only the results after a specified number
Bug fix for 'Get-JCSystem' to allow for pagination of over 1000 results.

FEATURES

  • Updated Function: Get-JCCommandResult with new parameters '-TotalCount' to return the total number of command results and '-Skip' to return only command results after a specificed number. Using '-TotalCount' to first find the total number of results before running a command you can then use '-Skip' to query the new command results after running the command.

BUG FIXES

  • Updated Functions: Get-JCSystem to allow for pagination of over 1000 results.

1.4.0

RELEASE DATE

May 18, 2018

RELEASE NOTES

Optimized Functions: Get-JCUser and Get-JCSystem have been overhauled!!
Optimized functions allow for searching using wildcards on all string properties,
boolean filters, and a new -filterDateProperty parameter.
The awesome news is these actions happen server side which speeds things up immensely.
Updated Functions: Invoke-JCCommand has added parameter '-NumberOfVariables'
This allows admins to pass variables into existing JumpCloud commands.
Bug fixes: Connect-JCOnline, Add-JCUserGroupMember, and Get-JCSystemGroupMember
Improvements: Optimized Helper Hash Functions to speed up hash table creation and overall performance.

FEATURES

  • Updated Function: Invoke-JCCommand has added parameter '-NumberOfVariables' for passing in variables to JumpCloud commands. This parameter will create additional parameters dynamically based on the number of variables being passed. Learn more about passing objects to JumpCloud commands under the heading 'Sending data with triggers' here.
  • Updated Function: Get-JCSystem to use the /search/systems API endpoint.
    • Get-JCSystem can now do front and end wild card searches on all string properties
      • Example 'Get-JCsystem -hostname '*admin*'
    • Get-JCSystem can now do date searches on 'Created' date field using new parameter -filterDateProperty
    • Get-JCSystem can now return only specific properties using new parameter -returnProperties
  • Updated Function: Get-JCUser to use the /search/systemusers API endpoint.
    • Get-JCUser can now do front and end wild card searches on all string properties
      • Example 'Get-JCUser -username '*bob*'
    • Get-JCUser can now do date searches on 'Created' and 'password_expiration_date' date fields using new parameter -filterDateProperty
    • Get-JCUser can now return only specific properties using new parameter -returnProperties

BUG FIXES

  • Updated Functions: Get-JCSystemGroupMember to properly paginate results greater than 100 system group members.
  • Updated Function: Add-JCUserGroupMember to handle user error additions more gracefully.
  • Updated Function: Connect-JCOnline to Write-Error instead of Write-Output if API key validation fails

IMPROVEMENTS

  • Updated Helper Hash Functions to leverage the -returnProperties which speeds up hash table creation and overall performance.

1.3.0

RELEASE DATE

April 27, 2018

RELEASE NOTES

New Function: Set-JCUserGroupLDAP to toggle the LDAP presentation on/off for JumpCloud user groups.
New Function: Get-JCCommandTarget to query the JumpCloud systems or system groups associated with a JumpCloud command.
New Function: Add-JCCommandTarget to add JumpCloud system or system group associations to JumpCloud commands.
New Function: Remove-JCCommandTarget to remove JumpCloud system or system group associations from JumpCloud commands.
Updated Functions: Add-JCUser and Set-JCUser with boolean parameter '-password_never_expires'

FEATURES

  • New Function: Set-JCUserGroupLDAP to toggle the LDAP presentation on/off for JumpCloud user groups.
  • New Function: Get-JCCommandTarget to query the JumpCloud systems or system groups associated with a JumpCloud command.
  • New Function: Add-JCCommandTarget to add JumpCloud system or system group associations to JumpCloud commands.
  • New Function: Remove-JCCommandTarget to remove JumpCloud system or system group associations from JumpCloud commands.
  • Updated Functions: Add-JCUser and Set-JCUser with boolean parameter 'password_never_expires'.

BUG FIXES

  • Updated Functions: Add-JCUser and Set-JCUser to allow UNIX_UID and UNIX_GUID to a value in the range 0-4294967295.
  • Updated Function: Get-JCSystemGroupMember to properly display output when using the 'ByID' parameter set.

1.2.0

RELEASE DATE

February 28, 2018

RELEASE NOTES

New Function New-JCCommand and Remove-JCCommand to create and remove JumpCloud commands from the shell.
New Function Import-JCCommand to import JumpCloud commands from a URL
Updated Function Get-JCUser to search users via username, firstname, lastname, or email
Updated Function Connect-JCOnline to check for and install module updates and added '-force' parameter for use in scripts and automation

FEATURES

  • New Function: New-JCCommand to create JumpCloud commands from the shell
  • New Function: Remove-JCCommand to delete JumpCloud commands
  • New Function: Import-JCCommand to import JumpCloud commands from a URL
  • Updated Function: Get-JCUser to use the same search endpoint as the UI. Get-JCUser can now search via 'username','firstname','lastname', or 'email'. By default Get-JCUser still returns all users.
  • Updated Function: Connect-JCOnline added banner to display current JumpCloud module version information. Added parameter sets for 'Interactive' and 'Force' modes. 'Interactive' displays banner and automatic module update options when new version becomes available. 'Force' can be used in automation scenarios to connect to JumpCloud and set $JCAPIKEY variable.

IMPROVEMENTS

  • Updated Function: Add-JCUserGroupMember with 'name' alias for 'GroupName' parameter to allow the command to accept pipeline input from the 'Get-JCGroup' command
  • Updated Function: Add-JCSystemGroupMember with 'name' alias for 'GroupName' parameter to allow the command to accept pipeline input from the 'Get-JCGroup' command
  • Updated Function: Remove-JCUserGroupMember with 'name' alias for 'GroupName' parameter to allow the command to accept pipeline input from the 'Get-JCGroup' command
  • Updated Function: Remove-JCSystemGroupMember with 'name' alias for 'GroupName' parameter to allow the command to accept pipeline input from the 'Get-JCGroup' command

1.1.0

RELEASE DATE

January 8, 2018

RELEASE NOTES

New function Set-JCSystemUser to set user / system permissions to standard or administrator.
Updated import functions and Add/Get-JCSystemUser to accommodate for user / system permissions.

FEATURES

  • New Function: Set-JCSystemUser can modify user/system permissions and change the user from a standard user to an administrator or vice versa
  • New Helper Function: Get-Hash_ID_Sudo hash table of UserID and ($true/$false) for Sudo parameter
  • New Helper Function: Get-Hash_SystemID_HostName hash table of SystemID and system DisplayName

IMPROVEMENTS

  • Updated Function: Add-JCSystemUser has boolean parameter '-Administrator' for setting system permissions during add
  • Updated Function: Get-JCSystemUser to show system permissions 'Administrator: $true/$false' and system DisplayName
  • Updated Function: New-JCImportTemplate to add in 'Administrator' header to .csv file when 'Y' is selected for 'Do you want to bind your new users to existing JumpCloud systems during import?'
  • Updated Function: Import-JCUserFromCSV to accept 'True/$True' and 'False/$False' or blank for the 'Administrator' header in the .csv import file
  • Updated Function: Import-JCUserFromCSV has switch '-Force' parameter to skip the Import GUI and data validation when importing users
  • Updated Function: Import-JCUserFromCSV to look for duplicate email addresses and usernames in import .csv as part of data validation
  • Updated Function: Get-JCGroup has -Name parameter which can be used to find attributes like the POSIX group number of a given group

BUG FIXES

  • Updated Function: Get-JCSystemUser to properly clear '$resultsArray' to display accurate results when recursivly listing system users
  • Updated Function: Connect-JCOnline and removed conflicting script variable scoping
  • Updated Function: Import-JCUserFromCSV will no longer inaccurately show 'Added' for users who were not bound to a system during import in the import results
PS> Get-Command -Module JumpCloud

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Add-JCSystemGroupMember                            1.1.0      JumpCloud
Function        Add-JCSystemUser                                   1.1.0      JumpCloud
Function        Add-JCUserGroupMember                              1.1.0      JumpCloud
Function        Connect-JCOnline                                   1.1.0      JumpCloud
Function        Get-JCCommand                                      1.1.0      JumpCloud
Function        Get-JCCommandResult                                1.1.0      JumpCloud
Function        Get-JCGroup                                        1.1.0      JumpCloud
Function        Get-JCSystem                                       1.1.0      JumpCloud
Function        Get-JCSystemGroupMember                            1.1.0      JumpCloud
Function        Get-JCSystemUser                                   1.1.0      JumpCloud
Function        Get-JCUser                                         1.1.0      JumpCloud
Function        Get-JCUserGroupMember                              1.1.0      JumpCloud
Function        Import-JCUsersFromCSV                              1.1.0      JumpCloud
Function        Invoke-JCCommand                                   1.1.0      JumpCloud
Function        New-JCImportTemplate                               1.1.0      JumpCloud
Function        New-JCSystemGroup                                  1.1.0      JumpCloud
Function        New-JCUser                                         1.1.0      JumpCloud
Function        New-JCUserGroup                                    1.1.0      JumpCloud
Function        Remove-JCCommandResult                             1.1.0      JumpCloud
Function        Remove-JCSystem                                    1.1.0      JumpCloud
Function        Remove-JCSystemGroup                               1.1.0      JumpCloud
Function        Remove-JCSystemGroupMember                         1.1.0      JumpCloud
Function        Remove-JCSystemUser                                1.1.0      JumpCloud
Function        Remove-JCUser                                      1.1.0      JumpCloud
Function        Remove-JCUserGroup                                 1.1.0      JumpCloud
Function        Remove-JCUserGroupMember                           1.1.0      JumpCloud
Function        Set-JCSystem                                       1.1.0      JumpCloud
Function        Set-JCSystemUser                                   1.1.0      JumpCloud
Function        Set-JCUser                                         1.1.0      JumpCloud

1.0.0

RELEASE DATE

November 29, 2017

PS > Get-Command -Module JumpCloud

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Add-JCSystemGroupMember                            1.0.0      JumpCloud
Function        Add-JCSystemUser                                   1.0.0      JumpCloud
Function        Add-JCUserGroupMember                              1.0.0      JumpCloud
Function        Connect-JCOnline                                   1.0.0      JumpCloud
Function        Get-JCCommand                                      1.0.0      JumpCloud
Function        Get-JCCommandResult                                1.0.0      JumpCloud
Function        Get-JCGroup                                        1.0.0      JumpCloud
Function        Get-JCSystem                                       1.0.0      JumpCloud
Function        Get-JCSystemGroupMember                            1.0.0      JumpCloud
Function        Get-JCSystemUser                                   1.0.0      JumpCloud
Function        Get-JCUser                                         1.0.0      JumpCloud
Function        Get-JCUserGroupMember                              1.0.0      JumpCloud
Function        Import-JCUsersFromCSV                              1.0.0      JumpCloud
Function        Invoke-JCCommand                                   1.0.0      JumpCloud
Function        New-JCImportTemplate                               1.0.0      JumpCloud
Function        New-JCSystemGroup                                  1.0.0      JumpCloud
Function        New-JCUser                                         1.0.0      JumpCloud
Function        New-JCUserGroup                                    1.0.0      JumpCloud
Function        Remove-JCCommandResult                             1.0.0      JumpCloud
Function        Remove-JCSystem                                    1.0.0      JumpCloud
Function        Remove-JCSystemGroup                               1.0.0      JumpCloud
Function        Remove-JCSystemGroupMember                         1.0.0      JumpCloud
Function        Remove-JCSystemUser                                1.0.0      JumpCloud
Function        Remove-JCUser                                      1.0.0      JumpCloud
Function        Remove-JCUserGroup                                 1.0.0      JumpCloud
Function        Remove-JCUserGroupMember                           1.0.0      JumpCloud
Function        Set-JCSystem                                       1.0.0      JumpCloud
Function        Set-JCUser                                         1.0.0      JumpCloud