Deprovision users and archive folders

This script allows you to deprovision and delete a list of users. It performs the following steps:

1. Transfers the user content to the another user's root folder under specified in EmployeeArchiveFolderName parameter.
2. Deletes the user.

Prerequisites

Windows

Install the latest version of dotnet core.

MacOS & Linux

Install PowerShell. Run the pwsh command to test the installation.

pwsh

Depending on the directory you are running the command in, the output may differ. For example:

PowerShell 7.2.5
Copyright (c) Microsoft Corporation.

https://aka.ms/powershell
Type 'help' to get help.

PS /Users/user/repos/boxcli/examples>

Box CLI

To use the script, you will need the Box CLI installed and configured. You can get this done by going through our quick start guide. The user you use to login with should be the main Box admin or co-admin.

Configure the script

1. Clone the boxcli GitHub repository and cd into this example's folder or download the files from examples directory.

   git clone https://github.com/box/boxcli.git boxcli
   cd boxcli/examples/User\ Deprovisioning/
   

2. Create the list of employees for deletion in .csv.

   The header row should look like as follows:

   name, email
   

   where:

   • name is the name of the user in Box.
   • email is the primary email address of the user in Box.

   For example:

   name	email
   Managed User 1	ManagedUser1@test.com
   Managed User 2	ManagedUser2@test.com
   Managed User 3	ManagedUser3@test.com

List of parameters

Define script parameters

You can the following options to pass parameters.

• Use hardcoded value in script.

  To use this option, update all required parameters listed in the script parameters section before running.

• Run script with parameters.

  You can specify parameters while providing the command. For example:

  PS > ./Users_Deprovision.ps1 -EmployeeList ./Employees_to_delete.csv `
  -NewFilesOwnerID  123456789
  -EmployeeArchiveFolderName "Employee Archive"
  

  or

  PS > ./Users_Deprovision.ps1 -EmployeeList ./Employees_to_delete.csv `
  -SkipTransferContent
  

  If you don't specify parameters, the script will prompt you to enter it.

  PS > ./Users_Deprovision.ps1
  Please enter the path to the employee list CSV file:
  ./Employees_to_delete.csv
  Please specify the user ID of the user who will own the files of the users being deprovisioned.
  Press Enter if you want to use the current user as the new owner.
  User ID: 1234567689
  Starting User Deprovisioning script...
  

Run the script

Now all you need to do is run the script.

1. Run the Powershell command.

   pwsh
   

2. Run the script:

   ./Users_Deprovision.ps1
   

   When all parameters are defined, you will see following output to confirm the script started:

   PS /home/rvb/box-cli/examples/User Deprovisioning> ./Users_Deprovision.ps1
   Starting User Deprovisioning script...
   

Logging

Logs are stored in a logs folder located in the main folder. You have access to these log files:

• Users_Deprovision_all.txt that contains all log entries
• Users_Deprovision_errors.txt that contains only errors.