非アクティブなユーザーのレポート
非アクティブなユーザーのレポート
このスクリプトは、一定の日数の間非アクティブであったユーザーのリストをCSVファイルで生成します。スクリプトによって以下の手順が実行されます。
-
user
ロールを持つユーザーを探します。 - Box Eventsを使用して、そのユーザーが一定の日数の間に操作を行ったかどうかを確認します。
デフォルトのイベントタイプのリストは、LOGIN
、UPLOAD
、COPY
、MOVE
、PREVIEW
、DOWNLOAD
、EDIT
、DELETE
、UNDELETE
、LOCK
、UNLOCK
、NEW_USER
です。このリストはスクリプトの設定で変更できます。 - 操作を行わなかったユーザーを、非アクティブなユーザーが含まれている
.csv
ファイルに追加します。このファイルは他のスクリプト (ユーザーのプロビジョニング解除など) の入力として使用できます。
前提条件
Windows
.NET Coreの最新バージョンのインストール
MacOSおよびLinux
PowerShellをインストールします。pwsh
コマンドを実行して、インストール結果をテストします。
pwsh
どのディレクトリでこのコマンドを実行するかに応じて、出力が異なる場合があります。以下に例を示します。
PowerShell 7.2.5
Copyright (c) Microsoft Corporation.
https://aka.ms/powershell
Type 'help' to get help.
PS /Users/user/repos/boxcli/examples>
Boxアプリケーション
スクリプトを使用するには、OAuth 2.0認証を使用するBoxアプリケーションが必要です。該当するアプリケーションがない場合は、開発者コンソールに移動して、OAuth 2.0を使用した設定ガイドに従ってください。
スクリプトの構成
-
boxcli
GitHubリポジトリを複製するか、examples
ディレクトリからファイルをダウンロードします。git clone https://github.com/box/boxcli.git
2. Set the number of days you want the script to scan for user events. If you don't specify this value or leave the default, the script will prompt you to enter it.
```bash
$daysInactive = "10"
-
(省略可) レポート出力ファイル名を変更するには、
ReportOutputFile
パラメータを定義します。$ReportOutputFile = $ReportName + ".csv"
4. (Optional) To change event types, define the list for `eventType` parameter.
```bash
$eventType = "LOGIN,UPLOAD,COPY,MOVE"
スクリプトの実行
ディレクトリを、スクリプトが格納されているフォルダに変更します。この例では、Inactive Users Report
フォルダになります。
rvb@lab:~/box-cli/examples/Inactive Users Report$ pwsh
PowerShell 7.2.4
Copyright (c) Microsoft Corporation.
https://aka.ms/powershell
Type 'help' to get help.
PS /home/rvb/box-cli/examples/Inactive Users Report>
スクリプトを実行します。
./Inactive_Users_Report.ps1
スクリプトの実行が完了すると、以下のような出力が表示されます。
Transfered employee content Managed User 1
with User ID: 19927131476 to Employee Archive Folder
Deleted user 19927131476
Deleted employee Managed User 1
ログ
ログは、メインフォルダ内のlogs
フォルダに格納されます。以下のログファイルにアクセスできます。
Inactive_Users_Report_all.txt
: すべてのログエントリが含まれています。Inactive_Users_Report_errors.txt
: エラーのみが含まれています。