ゴミ箱コマンド

ゴミ箱関連コマンドの説明

概要

削除済みレコードの一覧表示と管理が行えます。削除されたレコードはパージされるまでゴミ箱に残ります。

コマンド

CLIおよびSDKでゴミ箱を管理するときに、以下の操作が利用できます。

• ゴミ箱の一覧コマンド
• ゴミ箱からの復元コマンド
• ゴミ箱アイテムの参照コマンド
• ゴミ箱の共有解除コマンド
• ゴミ箱の完全削除コマンド

ゴミ箱の一覧コマンド

ボルトのゴミ箱内のレコードとフォルダを一覧表示します。ゴミ箱のレコードはメモリに読み込まれ、削除済み・孤立・共有フォルダとして分類して取得できます。

DotNet CLI

コマンド: trash

例:

My Vault> trash list
  #  Folder UID              Record UID              Name                             Record Type  Deleted At             Status
---  ----------------------  ----------------------  -------------------------------  -----------  ---------------------  ------
  1                          0thOtx4abVGBaNKcycX04Q  defws                            address                             Share 
  2  JSz1s5lZ_KUNwbCnvQZRPw                          testrtg                                       08/10/2025 5:07:04 AM  Folder

DotNet SDK

メソッド:

var deletedRecords = TrashManagement.GetDeletedRecords();
var orphanedRecords = TrashManagement.GetOrphanedRecords();
var sharedFolders = TrashManagement.GetSharedFolders();

これらを組み合わせれば、ゴミ箱のデータをすべて取得できます。

Power Commander

コマンド: Get-KeeperTrashList -Verbose

例

PS> Get-KeeperTrashList -Verbose                                      
VERBOSE: Starting trash list operation with pattern: ''

Folder UID             Record UID             Name                                                     Record Type   Deleted At            Status
----------             ----------             ----                                                     -----------   ----------            ------
                       0thOtx4abVGBaNKcycX04Q defws                                                    address                             Share
mdigPPSMrgKA_HIoz4q0ww B9hlKf_0Qitj_MX75JlZ-g test_share_folder_folder_record1234567898765432123456789 login         23/09/2025 7:13:21 AM Share
jWfCYHdhU0sx4-MKi6i6cQ                        tes_share_folder_folder_folder                           Shared Folder                       Folder
PDNS1vASSHMWOhdkBv9Vzg                        test_share_folder_folder@delete                          Shared Folder                       Folder
mdigPPSMrgKA_HIoz4q0ww                        test_share_folder_folder@delete                          Shared Folder                       Folder
JSz1s5lZ_KUNwbCnvQZRPw                        testrtg                                                  Shared Folder                       Folder

Python CLI

コマンド: trash list

フラグ:

-v --verbose 詳細出力を表示

--format 出力形式 - Table、JSON または CSV

--output 出力先ファイルのパス ("table" 形式では無視)

pattern ゴミ箱一覧時の検索条件

例:

My Vault> trash list
  #  Folder UID              Record UID              Name                           Record Type          Deleted At           Status
---  ----------------------  ----------------------  -----------------------------  -------------------  -------------------  --------
  1                          record_uid                                                                  2025-05-23 17:46:00  Record

Python SDK

関数: _ensure_deleted_records_loaded

trash_management.TrashManagement._ensure_deleted_records_loaded(vault)
deleted_records = TrashManagement.get_deleted_records()
orphaned_records = TrashManagement.get_orphaned_records()
deleted_shared_folders = TrashManagement.get_shared_folders()

ゴミ箱からの復元コマンド

ボルトのゴミ箱内のレコードを復元します。

DotNet CLI

コマンド: trash restore <recorduid>

例:

My Vault> trash restore 0thOtx4abVGBaNKcycX04Q
Successfully initiated restoration of 1 record(s)

DotNet SDK

メソッド: RestoreTrashRecords

public static async Task RestoreTrashRecords(VaultOnline vault, List<string> records)

await TrashManagement.RestoreTrashRecords(context.Vault, records);

Power Commander

コマンド: Restore-KeeperTrashRecords

例:

PS> Restore-KeeperTrashRecords -Records 0thOtx4abVGBaNKcycX04Q      
Successfully initiated restoration of 1 record(s)
Use 'Get-KeeperTrashList' to verify the restoration

Python CLI

コマンド: trash restore

パラメータ:

records 復元するレコードUIDの一覧

フラグ:

--force 確認メッセージをスキップする

-h, --help ヘルプを表示して終了する

例:

My Vault> trash restore <record_uid>
Do you want to restore 1 record(s)? [y/n]: y

Python SDK

関数: restore_trash_records

trash_management.restore_trash_records(vault, record_uids)
record_uids - list of uids
vault - vault instance

ゴミ箱アイテムの参照コマンド

ゴミ箱内のレコードを取得し、内容を表示します。

DotNet CLI

コマンド: trash get <recorduid>

例:

My Vault> trash get 0thOtx4abVGBaNKcycX04Q
                Title: defws
                 Type: address
              address: fdvefcq ₹ewrwfwv₹, esvbwqe, ₹webvwe bevwewds, DZ
   Direct User Shares: [e-mail] (Read Only) 

DotNet SDK

メソッド: 非対応

Power Commander

コマンド: Get-KeeperTrashedRecordDetails

PS> Get-KeeperTrashedRecordDetails

cmdlet Get-KeeperTrashedRecordDetails at command pipeline position 1
Supply values for the following parameters:
RecordUid: 0thOtx4abVGBaNKcycX04Q
                Title: defws
                 Type: address
              address: fdvefcq, ₹ewrwfwv₹, esvbwqe, ₹webvwe, bevwewds, DZ

Python CLI

コマンド: trash get

パラメータ:

record レコードUID

例:

My Vault> trash get <record_uid>
                Title: test_record
                 Type: login
                login: [e-mail]
             password: password
                  url: keepersecurity.com

Python SDK

関数: get_trash_record

trash_management.get_trash_record(vault, record_uid)

ゴミ箱の共有解除コマンド

ゴミ箱内レコードの共有を、他ユーザーのボルトから解除します。共有先のボルトにもレコードが残る場合があるため、孤立レコードの発生を防ぐ際に利用します。

DotNet CLI

コマンド: trash unshare <recorduid>

例:

My Vault> trash unshare B9hlKf_0Qitj_MX75JlZ-g
There are no records to unshare

DotNet SDK

メソッド: 非対応

Power Commander

コマンド: Remove-TrashedKeeperRecordShares

例:

Remove-TrashedKeeperRecordShares -Records "NyTgDxKnMRhcgpR_BGkFkw"

Python CLI

コマンド: trash unshare

パラメータ:

records レコードUID

フラグ:

--force 確認プロンプトをスキップする

-h, --help ヘルプを表示して終了する

例:

My Vault> trash unshare <record_uid>
Do you want to remove shares from 1 record(s)? [y/n]: y
My Vault>

Python SDK

関数: 非対応

ゴミ箱の完全削除コマンド

ゴミ箱内のすべてのレコードと共有フォルダを完全に削除 (パージ) します。

DotNet CLI

コマンド: trash purge

例:

My Vault> trash purge
Are you sure you want to permanently delete all records in trash? This action cannot be undone. (yes/No): s
Purge operation cancelled

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: Clear-KeeperTrash

例:

PS> clear-KeeperTrash   
Are you sure you want to permanently delete all records in trash? This action cannot be undone. (yes/No): yes
Successfully purged all records from trash

Python CLI

コマンド: trash purge

フラグ:

--force 確認プロンプトをスキップする

-h, --help ヘルプを表示して終了する

例:

My Vault> trash purge
Do you want to empty your Trash Bin? [y/n]: y
My Vault>

Python SDK

関数: purge_trash

trash_management.purge_trash(vault)