Skip to content

hardis:org:user:unfreeze

Description

Command Behavior

Unfreezes Salesforce user logins, restoring access for selected users.

This command allows administrators to unfreeze Salesforce user logins, reactivating their access to the Salesforce org. This is the counterpart to the freeze command and is used to restore access after a temporary suspension.

Key functionalities:

  • User Selection: You can select users to unfreeze based on their assigned profiles.
    • --includeprofiles: Unfreeze users belonging to a comma-separated list of specified profiles.
    • --excludeprofiles: Unfreeze users belonging to all profiles except those specified in a comma-separated list.
    • If no profile flags are provided, an interactive menu will allow you to select profiles.
  • Interactive Confirmation: In non-CI environments, it prompts for confirmation before unfreezing the selected users.
  • Bulk Unfreezing: Efficiently unfreezes multiple user logins using Salesforce's Bulk API.
  • Reporting: Generates CSV and XLSX reports of the users that are about to be unfrozen.
Technical explanations

The command's technical implementation involves:

  • SOQL Queries (Bulk API): It executes SOQL queries against the User and Profile objects to identify active users based on the provided profile filters. It then queries the UserLogin object to find frozen login sessions for these users.
  • Interactive Prompts: Uses the prompts library to guide the user through profile selection and to confirm the unfreezing operation.
  • Bulk Update: It constructs an array of UserLogin records with their Id and IsFrozen set to false, then uses bulkUpdate to perform the mass update operation on the Salesforce org.
  • Reporting: It uses generateReports to create CSV and XLSX files containing details of the users to be unfrozen.
  • Logging: Provides clear messages about the number of users found and the success of the unfreezing process.

Parameters

Name Type Description Default Required Options
debug
-d		 boolean Activate debug mode (more logs)
excludeprofiles
-e		 option List of profiles that you want to NOT unfreeze, separated by commas
flags-dir option undefined
includeprofiles
-p		 option List of profiles that you want to unfreeze, separated by commas
json boolean Format output as json.
maxuserdisplay
-m		 option Maximum users to display in logs 100
name
-n		 option Filter according to Name criteria
skipauth boolean Skip authentication check when a default username is required
target-org
-o		 option undefined
websocket option Websocket host:port for VsCode SFDX Hardis UI integration

Examples

$ sf hardis:org:user:unfreeze

$ sf hardis:org:user:unfreeze --target-org my-user@myorg.com

$ sf hardis:org:user:unfreeze --includeprofiles 'Standard'

$ sf hardis:org:user:unfreeze --excludeprofiles 'System Administrator,Some Other Profile'