レコードコマンド

レコード関連コマンドの説明

概要

本セクションでは、Keeperコマンダー (CLI) でボルト内のレコードを操作するコマンドを列挙します。この文脈での「レコードコマンド」は、レコードの追加・編集・取得などを指します。レコードや関連する添付ファイルの作成・参照・編集・整理・管理を扱います。

現在、次のコマンドをSDKで利用できます。

• レコード追加コマンド
• レコード更新コマンド
• レコード削除コマンド
• レコード検索・一覧コマンド
• レコード取得コマンド
• レコード履歴コマンド
• クリップボード出力コマンド
• 重複レコード検出コマンド

レコード専用コマンドに加え、SDKではレコード添付の機能も利用できます。詳細はこちらをご参照ください。次を含みます。

• 添付ファイルのアップロードコマンド
• 添付ファイルの削除コマンド
• 添付ファイルのダウンロードコマンド

レコード追加コマンド

このコマンドはKeeperボルトに従来型レコードを追加するために使います。すべてのレコードタイプ、カスタムタイプ、標準フィールド、カスタムフィールドを指定できます。階層型共有サブフォルダ (NSF) のレコードを追加する場合は、階層型共有サブフォルダのレコード追加コマンドをご利用ください。

DotNet CLI

コマンド : add-record

パラメータ:

パラメータ	説明
-t, --type	レコードタイプ (login、bankAccount、address など)
--title	レコードのタイトル

オプション:

オプション	説明
--folder	レコードを作成するフォルダー名またはUID
-g, --generate	ランダムパスワードを生成する
--self-destruct	一定時間後に自動削除 (5m、2h、1d など)

レコードフィールド:

fieldname=value 形式でフィールドを追加する。

login=username              # Username/login field
password=secret123          # Password field  
url=https://example.com     # URL field
notes="Additional info"     # Notes field

例:

My Vault> add-record --folder="Example Folder"  --type=login --title="Login Credentials" --generate login=test_user
Record created: record_uid

DotNet SDK

メソッド:

Task<KeeperRecord> CreateRecord(KeeperRecord record, string folderUid = null);

引数:

引数	型	必須	説明
record	KeeperRecord	はい	レコード情報を含むKeeperRecord型のデータ
folderUid	string	いいえ	レコードを作成するフォルダーのUID (既定: null = ルートフォルダー)

戻り値:

Task<KeeperRecord> — 付与されたUIDを持つ作成済みKeeperRecordを返すタスク

使用例: こちらをご参照ください

PowerCommander

コマンド : Add-KeeperRecord

別名: kadd

パラメータ:

オプション	説明
-RecordType	レコードタイプを指定する (既定: login)
-Title	レコードのタイトル

フラグ:

オプション	説明
-Folder	レコードを作成するフォルダーのUID
-GeneratePassword	ランダムパスワードを生成する。単独指定時は既定ルール (Length=20、Upper=4、Lower=4、Digit=2、Special=2) を使用する。
-PasswordRules	カスタム生成ルール: Length、Upper、Lower、Digit、Special。
例: -PasswordRules 20,5,5,5,5 値は5つ必須: Length、Upper、Lower、Digit、Special。
-SpecialChars	生成パスワードに記号を含める。
形式: Charset (charsetは任意)
例: -SpecialChars "!@#$"。 既定のcharsetは !@#$%()+;<>=?[]{}^.,
-Notes	レコードにメモを追加する
-SelfDestruct	共有レコードURLの有効期限 (形式: m、h、d。最大: 180日/6ヶ月)。閲覧から5分後にレコードが消える
-GeneratePassphrase	ランダムなパスフレーズを生成し、password フィールドに保存。-GeneratePassword とは同時指定不可。
単独指定時の既定値: 5語、"-" 区切り、useCaps=true、useDigits=true
-PassphraseRuleValues	パスフレーズのオプション設定 (指定時はパスフレーズも生成): WordCount, Separator, UseCaps, UseDigits。 例: -GeneratePassphrase -PassphraseRuleValues 5,-,true,true (WordCount: 5〜9。区切り: - . _ ! ? またはスペース)

例:

PS > Add-KeeperRecord -RecordType login -Folder folder_uid -Title "Login Crendentials PowerShell" -GeneratePassword login=<username>
Record created: record_uid

PS > kadd -RecordType login -Folder folder_uid -Title "Login Crendentials PowerShell" -GeneratePassword login=<username>
Record created: record_uid

使用例のサンプルはこちらをご参照ください

Python CLI

コマンド: record-add

パラメータ:

-t --title レコードのタイトル (必須)

-n --notes レコードのメモ

-rt --record-type レコードタイプ (必須)

--folder レコードを追加するフォルダー

--self-destruct 共有レコードURLの有効期限。m、h、d のいずれかで指定。最大 180d (6ヶ月)。閲覧から5分後にレコードが消える

-f --force 警告を無視しプロンプトをスキップする

fields <field_type>=<value> フィールドと値の一覧

パスワード生成:

パスワードフィールド (タイプ付きレコードのパスワードフィールドを含む) は、$GEN 値に対応しています。

利用可能なジェネレーター:

• password=$GEN:rand,20: ランダムパスワード。既定のアルゴリズム
• password=$GEN:dice,5: Diceware形式のパスワード
• password=$GEN:crypto: 暗号強度の強力なパスワード

パスフレーズジェネレーター:

password=$GEN:passphrase[,word_count][,separator][,capitalize][,number] を使用します。

• word_count: 任意。単語数。指定可能な範囲は 5〜9
• separator: 任意。1文字またはスペース。指定可能な値は -、.、_、?、!、space
• capitalize: 任意。true または false。各単語の先頭文字を大文字にする
• number: 任意。true または false。最初の単語の末尾に 0〜9 の数字を追加する

エンタープライズポリシー:

• パスフレーズの任意パラメータを省略した場合、単語数・区切り文字・大文字化・数字付加の既定値には、エンタープライズのパスフレーズポリシーが使用されます
• エンタープライズポリシーで passphrase-allow が無効になっている場合、生成はランダムパスワードにフォールバックし、警告がログに記録されます

例:

My vault> record-add --title='New Record' --notes='Create self destructing record' --record-type='Login' --folder='Record folder UID' --self-destruct=180d login=<username> password=<password> url=https://keepersecurity.com/vault/login

Record self-destructs on 01/07/2025 00:00:00 or after being viewed once. Once the link is opened the recipient will have 5 minutes to view the record.
https://keepersecurity.com/vault/share#XX1X1XXXX_00_00x00X0xxx00Xx_X0xXXX-x0X0X0xx

パスフレーズの例:

# 既定のパスフレーズ
record-add -t "My Login" -rt login login=[e-mail] password=$GEN:passphrase

# 7語、アンダースコア区切り、先頭大文字化、数字を付加
record-add -t "My Login" -rt login password=$GEN:passphrase,7,_,true,true

# 5語、ドット区切り、先頭大文字化なし、数字なし
record-add -t "My Login" -rt login password=$GEN:passphrase,5,.,false,false

# スペース区切り
record-add -t "My Login" -rt login password=$GEN:passphrase,6,space,true,true

Python SDK

関数: add_record_to_folder

vault = keepersdk.vault.vault_online.VaultOnline #initialize upon login

#Create record object based on record type
if record_type in ('legacy', 'general'):
    record = vault_record.PasswordRecord
else:
    record = vault_record.TypedRecord

#Assign field values based on fields and record type
set_fields(record, fields)

record.title = title
record.notes = notes

if attachments:
    keepersdk.vault.attachment.upload_attachments(vault, record, attachments)

record_uid = keepersdk.vault.record_management.add_record_to_folder(vault, record, folder_uid)

パスフレーズの例:

import sqlite3

from keepersdk import generator
from keepersdk.vault import sqlite_storage, vault_online, vault_record, record_management

# keeper_auth_contextはログインフローから取得
keeper_auth_context = ...  # noqa: F821

conn = sqlite3.Connection('file::memory:', uri=True)
vault_storage = sqlite_storage.SqliteVaultStorage(
    lambda: conn,
    vault_owner=bytes(keeper_auth_context.auth_context.username, 'utf-8'),
)
vault = vault_online.VaultOnline(keeper_auth_context, vault_storage)
vault.sync_down()

try:
    # パスフレーズを生成 (CLI: password=$GEN:passphrase,7,_,true,true)
    gen = generator.KeeperPassphraseGenerator.create_with_options(
        policy=None,
        word_count=7,
        separator='_',
        capitalize=True,
        append_number=True,
    )
    passphrase = gen.generate()

    # レガシーレコードを作成
    record = vault_record.PasswordRecord()
    record.title = 'My Login'
    record.login = '[e-mail]'
    record.password = passphrase
    record.link = 'https://example.com'
    record.notes = 'Created with SDK passphrase generation'

    folder_uid = None  # ルートフォルダ。フォルダUIDを指定することも可能
    record_uid = record_management.add_record_to_folder(vault, record, folder_uid)
    print(f'Added record {record_uid} with passphrase')

    vault.sync_down()
finally:
    vault.close()
    keeper_auth_context.close()

JavaScript SDK

関数: addRecord

public async addRecord(input: NewRecordInput): Promise<AddRecordResult> {
    const auth = this.getAuthOrThrow()
    const result = await addRecordOp(auth, input)
    if (result.success) await this.syncIfNeeded()
    return result
}

レコード更新コマンド

このコマンドはKeeperボルトの既存レコードを更新するために使います。

DotNet CLI

コマンド: update-record

パラメータ:

パラメータ	説明
record	更新するレコードのパスまたはUID

オプション:

オプション	説明
--title	レコードのタイトルを更新する
-t, --type	レコードタイプ (型付きレコードのみ)
-g, --generate	ランダムパスワードを生成し、既存のパスワードフィールドを更新する (既定: false)
--help	ヘルプ画面を表示する
--version	バージョン情報を表示する
fields	fieldname=value 形式で追加/更新するレコードフィールド

例:

My Vault> update-record record_uid --type=login --title="Login Credentials" --generate login
=test_users

DotNet SDK

メソッド:

Task<KeeperRecord> UpdateRecord(KeeperRecord record, bool skipExtra = true);

引数:

引数	型	必須	説明
record	KeeperRecord	はい	更新データを含むレコードオブジェクト (有効なUIDが必要)
skipExtra	bool	いいえ	ファイル添付情報の更新をスキップする (既定: true)

戻り値:

Task<KeeperRecord> — 更新後のKeeperRecordを返すタスク

例:

// Load existing record
var record = await vault.LoadRecord("ABC123XYZ456");

// Update as PasswordRecord
if (record is PasswordRecord passwordRecord)
{
    passwordRecord.Password = "NewSecurePassword123!";
    passwordRecord.Notes = "Password updated on " + DateTime.Now.ToString();
    
    // Update the record
    var updatedRecord = await vault.UpdateRecord(passwordRecord);
    Console.WriteLine($"Record updated: {updatedRecord.Title}");
}

アプローチ2:

複数レコードを一度に更新する場合、まとめて更新できる。

関数:

Task<IList<RecordUpdateStatus>> UpdateRecords(IEnumerable<KeeperRecord> records);

戻り値:

Task<IList<RecordUpdateStatus>> — 各レコードの更新ステータス一覧を返すタスク

RecordUpdateStatus のプロパティ:

プロパティ	型	説明
RecordUid	string	レコードのUID
Status	string	更新ステータス: "success" またはエラーメッセージ
Message	string	追加のステータスメッセージまたはエラー詳細

例:

// Update multiple records at once
var recordsToUpdate = new List<KeeperRecord>();

var record1 = await vault.LoadRecord("ABC123") as PasswordRecord;
record1.Password = "NewPassword1!";
recordsToUpdate.Add(record1);

var record2 = await vault.LoadRecord("DEF456") as PasswordRecord;
record2.Password = "NewPassword2!";
recordsToUpdate.Add(record2);

var record3 = await vault.LoadRecord("GHI789") as PasswordRecord;
record3.Password = "NewPassword3!";
recordsToUpdate.Add(record3);

var statuses = await vault.UpdateRecords(recordsToUpdate);

foreach (var status in statuses)
{
    if (status.Status == "success")
    {
        Console.WriteLine($"✓ Record {status.RecordUid} updated successfully");
    }
    else
    {
        Console.WriteLine($"✗ Record {status.RecordUid} failed: {status.Message}");
    }
}

PowerCommander

コマンド: Add-KeeperRecord

別名: kadd

パラメータ:

• -Uid : 更新対象レコードのレコードUid

フラグ:

オプション	説明
-GeneratePassword	レコード用の新しいパスワードを生成して更新する
-Title	更新後のタイトル
-Notes	レコードのメモを更新する
-Verbose	詳細な操作情報を表示する
-Debug	実行中のデバッグ情報を表示する
-ErrorAction	エラーへの応答方法 (Continue、Stop、SilentlyContinue、Ignore)
-WhatIf	コマンドレットを実際には実行せず、実行時の動作を表示する
-Confirm	実行前に確認プロンプトを表示する
-GeneratePassphrase	ランダムなパスフレーズを生成し、password フィールドに保存。-GeneratePassword とは同時指定不可。 単独指定時の既定値: 5語、"-" 区切り、useCaps=true、useDigits=true
-PassphraseRuleValues	パスフレーズのオプション設定 (指定時はパスフレーズも生成): WordCount, Separator, UseCaps, UseDigits。 例: -GeneratePassphrase -PassphraseRuleValues 5,-,true,true (WordCount: 5〜9。区切り: - . _ ! ? またはスペース)

要件:

このコマンドは現在のフォルダー内のレコードを更新します。先に、対象フォルダーへカレントを移してください。Set-KeeperFolder コマンドで行えます (参考)。

例:

PS > Add-KeeperRecord -Uid "record_uid" -Title "Updated Title" login=[e-mail]
Record updated: record_uid
UID                    Type    Title           Info
---                    ----    -----           ----
record_uid             login   Updated Title   [e-mail]

PS > kadd -Uid "record_uid" -Title "Updated Title" login=[e-mail]
Record updated: record_uid
UID                    Type    Title           Info
---                    ----    -----           ----
record_uid             login   Updated Title   [e-mail]

Python CLI

コマンド: record-update

パラメータ:

-t --title レコードタイトルを変更する (必須)

-rt --record-type レコードタイプを変更する (必須)

-n --notes メモを追記/変更する

-r --record 変更対象のUIDまたはパス (必須)

fields <field type>=<value> フィールドと値の一覧

オプション:

-f --force 警告を無視する

パスワード生成:

$GEN は、レガシーレコードとタイプ付きレコードのいずれのパスワードフィールドでも使用できます。

対応アルゴリズム:

• password=$GEN:rand,20: ランダムパスワード。既定のアルゴリズム
• password=$GEN:dice,5: Diceware形式のパスワード
• password=$GEN:crypto: 暗号強度の強力なパスワード
• password=$GEN:passphrase[,word_count][,separator][,capitalize][,number]: パスフレーズジェネレーター

パスフレーズパラメータ:

パラメータ	必須	説明
word_count	いいえ	5〜9 語。既定は 5 またはエンタープライズポリシーの値
separator	いいえ	-、.、_、?、!、space のいずれか。既定は -
capitalize	いいえ	true または false。各単語の先頭文字を大文字にする
number	いいえ	true または false。最初の単語の末尾に数字を追加する

例:

# デフォルトのパスフレーズにパスワードをローテーション
record-update -r "My Login" password=$GEN:passphrase

# 7語、アンダースコア区切り、先頭大文字化、数字を付加
record-update -r IQ_recordUid password=$GEN:passphrase,7,_,true,true

# タイプ付きログインレコード
record-update -r "Server Login" login=admin password=$GEN:passphrase,5,-,true,true

# タイトルとパスワードを同時に更新
record-update -r IQ_recordUid -t "Updated Login" password=$GEN:passphrase,6,space,true,false

Python SDK

関数: update_record

例:

from keepersdk import generator
from keepersdk.vault import vault_record, record_management

record_uid = 'IQ_yourRecordUid'
record = vault.vault_data.load_record(record_uid)

# CLIでの同等コマンド: password=$GEN:passphrase,7,_,true,true
gen = generator.KeeperPassphraseGenerator.create_with_options(
    policy=None,
    word_count=7,
    separator='_',
    capitalize=True,
    append_number=True,
)
new_passphrase = gen.generate()

if isinstance(record, vault_record.PasswordRecord):
    record.password = new_passphrase
elif isinstance(record, vault_record.TypedRecord):
    pwd_field = record.get_typed_field('password')
    if pwd_field:
        pwd_field.value = [new_passphrase]
    else:
        pwd_field = vault_record.TypedField.create_field('password')
        pwd_field.value = [new_passphrase]
        record.fields.append(pwd_field)

record_management.update_record(vault, record)
vault.sync_down()

JavaScript SDK

関数: updateRecord

public async updateRecord(recordUid: string, data: TypedRecordData): Promise<UpdateRecordResult> {
    const auth = this.getAuthOrThrow()
    const record = this.getRecordByUid(recordUid)
    if (!record) {
        return { recordUid, success: false, status: VaultStatus.RecordNotFound }
    }
    const keyBytes = await this.storage.getKeyBytes(recordUid)
    if (!keyBytes) {
        return {
            recordUid,
            success: false,
            status: VaultStatus.RecordKeyNotFound,
        }
    }

レコード削除コマンド

個人用ボルトフォルダーから複数のレコードを削除するために使います。削除したレコードはオーナーのボルトに残り、すべてのインスタンスが削除されるとオーナーのゴミ箱に残ります。

DotNet CLI

コマンド: rm

フラグ:

• --help : このヘルプ画面を表示する。
• --version : バージョン情報を表示する。
• record title, uid, or pattern : 削除するレコードのUID/タイトル。

例:

My Vault> rm record_uid
1 Record(s) will be removed from shared folders.  Access to these records will no longer be available to members of these shared folders.
Note: If the last reference to a record is removed, the record can be found in the owner's trash can. If the trash can is then emptied, the record is no longer recoverable.
Type "yes" to confirm, <Enter> to cancel
> yes

DotNet SDK

メソッド: DeleteRecords

Task DeleteRecords(RecordPath[] records);

引数:

records - レコードパスの配列。

例外:

Authentication.KeeperApiException

PowerCommander

コマンド: Remove-KeeperRecord

別名: kdel

パラメータ:

• Name - 削除するレコード名

例:

PS > Remove-KeeperRecord -Name "abc123xyz"
PS > kdel "RecordUID1", "RecordUID2"

Python CLI

コマンド: rm

パラメータ:

• records 削除するレコードのUid (必須)

オプション:

• -f --force 確認なしで削除する

例:

My Vault> rm record_uid
1 Record(s) will be removed from your personal folder.
Note: If the last reference to a folder is removed, it can be found in the owners trash can. If the trash can is then emptied, the record is no longer recoverable. (y/n): y

Python SDK

関数: delete_vault_objects

例:

record_management.delete_vault_objects(
            vault=context.vault,
            vault_objects=record_uids, #str
            confirm=confirm_fn #Optional - send a callable function for confirm deletion
        )

JavaScript SDK

関数: deleteRecord

public async deleteRecord(recordUid: string): Promise<DeleteRecordResult> {
        const auth = this.getAuthOrThrow()
        const result = await deleteRecordOp(auth, recordUid)
        if (result.success) await this.syncIfNeeded()
        return result
    }

レコード検索・一覧コマンド

このコマンドはKeeperボルト内のすべてのレコードを表形式で一覧表示します。各行にレコードUID、タイトル、タイプ、説明、他ユーザーとの共有の有無が含まれます。

DotNet CLI

コマンド: search

パラメータ:

• argument 1 : 検索で照合するパターン (必須)。

フラグ:

• --verbose : すべてのデータを表示する
• --limit : 表示するレコード数

例:

My Vault> search demo
  #  Record UID              Title                      Type   Info                                         
---  ----------------------  -------------------------  -----  ---------------------------------------------
  1  record_uid              Demo Record 1              login  [e-mail] (at) https://demo.acmecorp.com
  2  record_uid              DemoRecordForWeakPassword  login  [e-mail]                                

First 2 found records are shown.

DotNet SDK

メソッド: vault.KeeperRecords

同様の動作には、ボルトコンテキストのKeeperレコード一覧から取得する。

vault.KeeperRecords
                .Where(x => options.Verbose || x.Version == 2 || x.Version == 3)

Power Commander

コマンド: Get-KeeperRecord

別名: kr

オプション:

-Uid - レコードuidで絞り込む。

-Filter - UID、タイトル、タイプ、説明で絞り込む。

Python CLI

コマンド: list

別名:l

オプション:

-t --type 特定タイプのレコードのみ一覧する。繰り返し指定可

-v --verbose 長いタイトルを表示する

--format Table、csv、json

--output 出力先ファイルのパス

search_text 一覧の条件

例:

My Vault> list

  #  Record UID              Type     Title                            Description                                Shared
---  ----------------------  -------  -------------------------------  -----------------------------------------  --------
  1  record_uid              login    abc                              [e-mail]                              True

Python SDK

関数: find_records

例:

records = [x for x in vault.vault_data.find_records(criteria=Optional[str], record_type=Optional[Union[str, Iterable[str]]], record_version=Optional[Union[int, Iterable[int]]])]

注:

• criteria : レコードに含まれるテキスト
• record_types : 指定タイプのレコードを返す
• record_version : 指定バージョンのレコードを返す

JavaScript SDK

関数: getRecords

public getRecords(): DRecord[] {
    return this.storage.getRecords()
}

レコード取得コマンド

このコマンドはレコードの取得専用です。DotNetおよびPython SDKのgetはその他コマンドに分類され、レコード・チーム・フォルダー・共有フォルダーを取得します。

DotNet CLI

コマンド: get

パラメータ:

• uid : レコード、共有フォルダー、またはフォルダーのUid

例:

My Vault> get record_uid                       

                    Record UID:  record_uid                
                          Type:  login                                 
                         Title:  Login Record                          
                         Notes:                                        
                      $passkey:                                        
                        $login:  [e-mail]                   
                     $password:  random_password                  
                          $url:                                        
                      $fileRef:                                        
                 Last Modified:  Wednesday, August 13, 2025 12:04:28 PM
                                                                       
                   User Shares:                                        
       [e-mail]  Can Edit                              
       [e-mail]  Owner                                 
                                                                       
                Shared Folders:                                        
                New Test Folder  Read Only                             

DotNet SDK

現在のdotnet CLIでの実装は、与えられたUIDを複数カテゴリから検索する流れに従います。

vault.TryGetKeeperRecord(uid, out var record)

UIDがレコードにない場合は、共有フォルダー側でUIDを検索します。

vault.TryGetSharedFolder(uid, out var sf)

共有フォルダーにない場合は、フォルダーを確認します。

vault.TryGetFolder(uid, out var f

Power Commander

コマンド: Get-KeeperRecord

別名: kr

パラメータ:

• Uid : 一致するUidのレコードを返す

フラグ:

• Filter : レコード内容を指定値と照合し、一致するものを返す
• RecordType : レコードタイプで絞り込む (例: "login"、"address"、"payment_card")

例:

# Get specific record
PS > Get-KeeperRecord -Uid "abc123xyz"
PS > kr -Uid "abc123xyz"

# Get all records
PS > Get-KeeperRecord
PS > kr

# Search records
PS > Get-KeeperRecord -Filter "gmail"
PS > kr -Filter "password"

Python CLI

コマンド: get <UID>

パラメータ:

• uid 検索するUIDまたはタイトル (-f、-t、-r 使用時は任意)
• -f, --folder 検索するフォルダーUIDまたはタイトル
• -t, --team 検索するチームUIDまたはタイトル
• -r, --record 検索するレコードUIDまたはタイトル

オプション:

--format 対応する表示形式 - json、details、fields、password

--unmask パスワードなど機密データを出力に含める

--legacy 型付きレコードをレガシーとして表示する

例:

My Vault> get record_uid

                 UID: record_uid
                Type: login               
               Title: test
               login: 134234           
            password: ********            
                 url: https://email.com   

User Permissions:

User: [e-mail]
Shareable: Yes
Read-Only: No


Shared Folder Permissions:

Shared Folder UID: shared_folder_uid


Share Admins:
[e-mail]

Python SDK

関数: load_record

例:

record = vault.vault_data.load_record(record_uid=uid)

load_recordはレコードの詳細を返します。レコードには次の4種類があります。

• PasswordRecord - レガシーまたは一般
• TypedRecord
• FileRecord
• ApplicationRecord

これらのクラスはkeepersdk.vault.vault_recordで定義されています。

JavaScript SDK

関数: findRecord

public findRecord(uidOrTitle: string): DRecord | undefined {
    const byUid = this.getRecordByUid(uidOrTitle)
    if (byUid) return byUid
    const lowerUidOrTitle = uidOrTitle.toLowerCase()
    return this.getRecords().find((record) => getRecordTitle(record).toLowerCase() === lowerUidOrTitle)
}

レコード履歴コマンド

このコマンドは、(既定アクションで) レコードのリビジョンや変更の一覧表示、特定リビジョンの表示、リビジョン間の差分表示、旧リビジョンの復元に使います。ここでのリビジョンは、特定レコードの変更バージョンに相当します。

DotNet CLI

コマンド: record-history

パラメータ:

• recordUid : 履歴を参照するレコードのUID。

例:

My Vault> record-history UTgy0U90whWp78sFAcsav
Version  Modification Date       Username                       Changed        
-------  ----------------------  -----------------------------  ---------------
V.2      9/30/2025 1:00:20 PM     [e-mail]                  Login, Password
V.1      12/19/2024 12:23:45 PM   [e-mail]               

DotNet SDK

メソッド: GetRecordHistory

public async Task<RecordHistory[]> GetRecordHistory(string recordUid)

引数:

recordUid : 履歴を表示するレコードのUID

Power Commander

コマンド: Get-KeeperRecordHistory

パラメータ:

-Format Table、csv、Json

-Output 出力先ファイルのパス。

-a -Action 対応アクション: list、diff、view、restore

-r, -Revision 表示または復元対象のリビジョン

-Record レコードUIDまたはパス (必須)

例:

PS > Get-KeeperRecordHistory -Record "<recordUidOrName_here>"

Record History: Test1
UID: <recordUid_here>

Version ModifiedBy                    TimeModified
------- ----------                    ------------
Current [e-mail]                2026-02-16 08:50:30
V.6     [e-mail]                2026-02-16 08:48:37
V.5     [e-mail]                2026-02-16 08:40:48
V.4     [e-mail]                2026-02-16 08:39:27
V.3     [e-mail]                2026-02-16 08:38:32
V.2     [e-mail]                2026-02-06 17:39:52
V.1     [e-mail]                2026-02-05 10:42:05

Total versions: 7

Python CLI

コマンド: record-history

パラメータ:

--format Table、csv、Json

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

-a --action 対応アクション: list、diff、view、restore

-r, --revision 表示または復元対象のリビジョン

record レコードUIDまたはパス (必須)

オプション:

• -v, --verbose 詳細出力を表示する

例:

My Vault> record-history -a='list' record_uid
Version    Modified By                      Time Modified
---------  -------------------------------  -------------------
Current    [e-mail]      2025-09-30 18:36:58
V.5        [e-mail]      2025-09-26 18:00:27
V.4        [e-mail]      2025-09-24 11:51:50
V.3        [e-mail]      2024-12-30 12:21:59
V.2        [e-mail]      2024-12-02 12:39:20
V.1        [e-mail]      2024-12-02 12:16:15

Python SDK

関数: 非対応

JavaScript SDK

関数: getRecordHistory

public async getRecordHistory(recordUid: string): Promise<RecordHistoryResult> {
    const auth = this.getAuthOrThrow()
    const keyBytes = await this.storage.getKeyBytes(recordUid)
    if (!keyBytes) {
        return { recordUid, history: [] }
    }
    return getRecordHistoryOp(auth, recordUid, keyBytes)
}

クリップボード出力コマンド

このコマンドはレコードからデータ (パスワード、ログイン、TOTP、カスタムフィールド) を取得し、クリップボード、標準出力、環境変数などへ出力します。

このコマンドの別名は find-password です。

DotNet CLI

コマンド: clipboard-copy

別名: cc, find-password

フラグ:

• record: データ取得元のレコードパスまたはUID
• --username : 同名レコードが複数あるときログイン名で一致させる
• --output : 出力先 - 値: clipboard (既定)、stdout、stdouthidden、variable
• --name : 出力が variable のときの変数名
• --copy-uid : パスワードの代わりにUIDを出力する
• -l, --login : パスワードの代わりにログイン名を出力する
• -t, --totp : パスワードの代わりにTOTPコードを出力する
• --field : 特定のカスタムフィールドを出力する (ネストは field:property)
• -r, --revision : 指定したレコードリビジョンを使う

例:

MyVault> clipboard-copy myrecord

MyVault> cc myrecord --output stdout

MyVault> find-password myrecord --login

MyVault> clipboard-copy myrecord --totp

MyVault> clipboard-copy myrecord --field notes

MyVault> clipboard-copy myrecord --field phone:number

MyVault> clipboard-copy myrecord --output variable --name MY_PASSWORD

MyVault> clipboard-copy myrecord --username [e-mail]

Power Commander

PowerCommanderでは、このコマンドに以下の2つの実装があります。

1. フィールドとデータをクリップボードへコピー

コマンド : Copy-KeeperToClipboard [-Record] [-Field] [-Output] [-Username] [-Login] [-Totp] [-CopyUid] [-Name] [-Revision]

パラメータ

パラメータ	説明
Record	レコードUID、タイトル、またはUidプロパティを持つオブジェクト。
Field	コピーするフィールド。Login、Password、URL、Notes、または任意のカスタムフィールド名。
Output	出力先: Clipboard、Stdout、StdoutHidden、Variable。
Username	同一タイトルが複数あるとき、正しいレコードを選ぶためのログイン名。
Login	パスワードの代わりにログインフィールドをコピーする。別名: -l
Totp	パスワードの代わりにTOTPコードをコピーする。別名: -t
CopyUid	パスワードの代わりにレコードUIDをコピーする。
Name	Output が Variable のときの変数名。
Revision	履歴の特定リビジョンを使用する (1 = 1つ前、2 = 2つ前 など)。別名: -r

例

# Copy password to clipboard (default behavior)
Copy-KeeperToClipboard "Test"   
Copied to clipboard: Password for Test

# Copy login instead of password
Copy-KeeperToClipboard "Test" -Login   
Copied to clipboard: Login for Test

# Copy TOTP code
Copy-KeeperToClipboard "Test" -Totp   
Copied to clipboard: TOTP for Test

# Copy a custom field
Copy-KeeperToClipboard "Test" -Field "API Key"   
Record Test12 has no API Key

# Output to console
Copy-KeeperToClipboard "Test" -Output Stdout   
123456

# Store in variable
Copy-KeeperToClipboard "Test" -Output Variable -Name "myPassword"   
Password is set to variable "myPassword"

# Print the password which you stored in variable
$env:myPassword
123456

# Copy previous version from history
Copy-KeeperToClipboard "Test" -Revision 1   
Copied to clipboard: Password for Test

Copy-KeeperToClipboard "Test" -Revision 2
Copied to clipboard: Password for Test

# Copy UID itself
copy-KeeperToClipboard "Test" -CopyUid
Copied to clipboard: UID for Test

# Select by username when multiple records have same title
Copy-KeeperToClipboard "Test" -Username "[e-mail]"
Copied to clipboard: Password for Test

1. Keeper添付ファイルをストリームへコピー

コマンド: Copy-KeeperFileAttachmentToStream

Keeperレコードから1件のファイル添付をダウンロードします。出力モードは以下の2種類です。

• -Path: 添付をファイルへ書き込み。親ディレクトリがなければ自動作成。ディスクへの保存向け
• -Stream: 添付データを既存の System.IO.Stream オブジェクトへ書き込み。メモリ上での処理、パイプ、カスタム処理向け

レコードは レコードUID または レコードタイトル で指定できます。複数の添付がある場合は -Name でファイル名または添付IDを指定します。添付が1件のみの場合は -Name を省略できます。

---

パラメータ

パラメータ	型	必須	説明
Record	string	はい	KeeperレコードUIDまたはレコードタイトル
Name	string	いいえ	添付ファイル名または添付ID (添付が1件のみの場合は省略可)
Path	string	はい*	添付の保存先パス (`-Stream` 未使用時は必須。必要に応じてディレクトリを作成)
Stream	System.IO.Stream	はい*	添付データを受け取る書き込み可能なストリーム (`-Path` 未使用時は必須)

-Path と -Stream は同時指定不可。いずれか一方が必須。

例

ファイルへ添付をダウンロード

指定パスへ添付を保存する例。対象ディレクトリが存在しない場合は自動作成されます。

Copy-KeeperFileAttachmentToStream -Record "ABxzAJFeEd_pRAFbcqGCJA" -Name "download.png" -Path "C:\Downloads\file.png"

レコードタイトルと添付名で指定する例

Copy-KeeperFileAttachmentToStream -Record "My Server Config" -Name "config.json" -Path ".\config.json"

添付が1件のみの場合は -Name を省略

Copy-KeeperFileAttachmentToStream -Record "ABxzAJFeEd_pRAFbcqGCJA" -Path "C:\Downloads\attachment.bin"

ストリームへ添付をダウンロード (メモリ上)

MemoryStream へ添付を書き込み、データを読み取りまたは処理する例

$ms = [System.IO.MemoryStream]::new()
Copy-KeeperFileAttachmentToStream -Record "ABxzAJFeEd_pRAFbcqGCJA" -Name "data.txt" -Stream $ms
$ms.Position = 0
$reader = [System.IO.StreamReader]::new($ms)
$content = $reader.ReadToEnd()
$reader.Dispose()
$ms.Dispose()

別のリーダー (バイナリなど) でストリームを使う例

$ms = [System.IO.MemoryStream]::new()
Copy-KeeperFileAttachmentToStream -Record "My Record" -Stream $ms
$ms.Position = 0
# Process $ms as needed (e.g. [System.IO.BinaryReader])
$ms.Dispose()

Python CLI

コマンド : clipboard-copy

パラメータ: record レコードパスまたはUID --username ログイン名で照合 (任意) --output {clipboard, stdout, stdouthidden, variable} パスワードの出力先 --name 出力が variable の場合の変数名 -cu, --copy-uid パスワードの代わりにUIDを出力 -l, --login ログイン名を出力 -t, --totp TOTPコードを出力 --field カスタムフィールドを出力 -r, --revision 特定のレコードリビジョンを使用

例:

My Vault> cc <record_uid>
Password copied to clipboard

Python SDK

関数: 非対応

JavaScript SDK

関数: getRecordPassword

export function getRecordPassword(record: DRecord): string | undefined {
    return getRecordSummary(record).password
}

重複レコード検出コマンド

このコマンドは、さまざまな照合条件に基づきボルト内の重複レコードを検索します。重複の表示、または自動マージ/削除が行えます。

DotNet CLI

コマンド: find-duplicates

フラグ:

• --title : タイトルで重複を照合する
• --login : ログインで重複を照合する
• --password : パスワードで重複を照合する
• --url : URLで重複を照合する (結果にもURLを表示)
• --shares : 共有権限で重複を照合する
• --full : カスタムフィールドを含むすべてのフィールドで照合する
• -m, --merge : 重複レコードを統合する (各グループで先頭以外を削除)
• --ignore-shares-on-merge : マージ用のグループ化で共有権限を無視する
• -f, --force : 確認なしで削除する (--merge 指定時のみ有効)
• -n, --dry-run : 実際には削除せずシミュレーションする (--merge 指定時のみ有効)
• -q, --quiet : 画面出力を抑止する (--force 指定時のみ有効)
• -s, --scope : 検索範囲 - 値: vault (既定)、enterprise
• -r, --refresh-data : 最新データでローカルキャッシュを更新する (--scope=enterprise 指定時のみ有効)

例:

MyVault> find-duplicates --title --login

MyVault> find-duplicates --password --url

MyVault> find-duplicates --full

MyVault> find-duplicates --title --login --merge

MyVault> find-duplicates --title --login --merge --force

MyVault> find-duplicates --title --login --merge --dry-run

MyVault> find-duplicates --shares --scope vault

Power Commander

コマンド : Find-KeeperDuplicateRecords [-Title] [-Login] [-Password] [-Url] [-Shares] [-Full] [-Merge] [-Force] [-DryRun] [-Quiet] [-IgnoreSharesOnMerge] [-Scope ] [-RefreshData] [-Format ] [-Output ]

パラメータ

パラメータ	説明
Title	タイトルフィールドで重複を照合する。
Login	ログインフィールドで重複を照合する。
Password	パスワードフィールドで重複を照合する。
Url	URLフィールドで重複を照合する。
Shares	共有権限で重複を照合する。
Full	すべてのフィールド (タイトル、ログイン、パスワード、url、カスタム、共有) で照合する。
Merge	重複を削除する (各グループの先頭レコードを残す)。
Force	確認なしで削除する (-Merge が必要)。
DryRun	削除せずシミュレーションする (-Merge が必要)。
Quiet	出力を抑止する (-Force が必要)。
IgnoreSharesOnMerge	マージ照合で共有権限を無視する。
Scope	検索範囲: vault または enterprise。
RefreshData	キャッシュを更新する (-Scope enterprise が必要)。
Format	出力形式: table、csv、json。
Output	結果をファイルにエクスポートする。

例

# Find all records with duplicate titles
Find-KeeperDuplicateRecords -Title
Find duplicated records by: Title

Duplicates Found:
Group Title Login       UID                    RecordOwner                   SharedTo
----- ----- -----       ---                    -----------                   --------
    1 Test1 [e-mail] a3sADrCdf-E_nmO5M_wGNg [e-mail]                [e-mail]                     
      Test1 [e-mail] lyzT2qwFYJdvuuOJlwKNjw [e-mail]                [e-mail]                     
      Test1 [e-mail] nZHx5lJnft4nC3dM32IWxQ [e-mail]                [e-mail]                     

Total: 1 duplicate groups, 3 records


# Find duplicates by specific fields (title, login, password, url, shares)
Find-KeeperDuplicateRecords -Title -Login -Password -Url -Shares
Find duplicated records by: Title, Login, Password, URL, Shares

Duplicates Found:
Group Title Login       Url               UID                    RecordOwner                   SharedTo      
----- ----- -----       ---               ---                    -----------                   --------      
    1 Test1 [e-mail] https://agoda.com a3sADrC1R-E_nmO5M_wGNg [e-mail]                [e-mail]                 
      Test1 [e-mail] https://agoda.com lyzT2gZFYJdvuuOJlwKNjw [e-mail]                [e-mail]                 

Total: 1 duplicate groups, 2 records


# Find duplicates by all fields and export to file (supports table, csv, json formats)
Find-KeeperDuplicateRecords -Full -Format csv -Output duplicates.csv
Find duplicated records by: All Fields

Duplicates Found:
Results exported to: duplicates.csv

Group       : 1
Title       : Test1
Login       : [e-mail]
UID         : a3sADrC1R-E_nmO5M_wGNg
RecordOwner : [e-mail]                
SharedTo    : [e-mail]                

Group       : 
Title       : Test1
Login       : [e-mail]
UID         : lyzT2gZFYJqwvuuOJlwKNjw
RecordOwner : [e-mail]                
SharedTo    : [e-mail] 


# Simulate merging duplicates with dry run, then merge with force and quiet
Find-KeeperDuplicateRecords -Full -Merge -DryRun
Find duplicated records by: All Fields

DRY RUN MODE: No records will be removed
The following 1 duplicate record(s) will be removed:

Title UID                    Login
----- ---                    -----
Test1 lyzT2gZFYJdqwuOJlwKNjw [e-mail]

DRY RUN: No records were removed.


# Merge duplicates ignoring share permissions (useful when records have different shares)
Find-KeeperDuplicateRecords -Merge -IgnoreSharesOnMerge
Find duplicated records by: All Fields (ignoring shares for merge)

The following 2 duplicate record(s) will be removed:

Title UID                    Login
----- ---                    -----
Test1 a3sADrC1R-E_nmO5M_wGNg [e-mail]
Test1 h4wCKmKj1euJALxPBGTxAw [e-mail]

Removing duplicate records...
Successfully removed 2 duplicate record(s).
Syncing vault...
Vault synced.

Python CLI

コマンド : find-duplicate

パラメータ:

--format {table, csv, json} 出力形式 --output 結果の出力ファイルパス (table 形式では無視) --title タイトルで重複を照合 --login ログインで重複を照合 --password パスワードで重複を照合 --url URLで重複を照合 --shares 共有権限で重複を照合 --full すべてのフィールドで重複を照合 -m, --merge 重複レコードを統合 (すべてのフィールドと共有を含めて照合) --ignore-shares-on-merge マージ用のグループ化で共有権限を無視 -f, --force 確認なしで重複を削除 (--merge 指定時のみ有効) -n, --dry-run 重複削除をシミュレーション (このフラグではレコードは削除・変更されない)。--merge 指定時のみ有効 -q, --quiet 画面出力を抑止 (--force 指定時のみ有効) -s, --scope {vault, enterprise} 検索範囲 (未指定時は現在のボルトに限定) -r, --refresh-data 最新のコンプライアンスデータでローカルキャッシュを更新 (--scope=enterprise 指定時のみ有効)

Python SDK

関数:

    vault.sync_down()

    print("Finding Duplicate Records")
    print("-" * 50)
    
    print("\nDuplicate detection options:")
    print("1. By title")
    print("2. By title and username")
    print("3. By title and URL")
    print("4. By all fields (title, username, URL)")
    
    choice = input("\nSelect option (1-4, default=1): ").strip() or "1"
    
    match_title = True
    match_login = choice in ["2", "4"]
    match_url = choice in ["3", "4"]
    
    print(f"\nSearching for duplicates...")
    print(f"Matching by: Title={match_title}, Username={match_login}, URL={match_url}")
    print("-" * 50)
    
    duplicates_map: Dict[str, List[vault_record.KeeperRecordInfo]] = {}
    
    for record_info in vault.vault_data.records():
        try:
            record = vault.vault_data.load_record(record_info.record_uid)
            
            key_parts = []
            
            if match_title:
                title = record.title.lower().strip() if record.title else ""
                key_parts.append(f"title:{title}")
            
            if match_login and isinstance(record, vault_record.PasswordRecord):
                login = record.login.lower().strip() if record.login else ""
                key_parts.append(f"login:{login}")
            
            if match_url:
                url = ""
                if isinstance(record, vault_record.PasswordRecord):
                    url = record.link.lower().strip() if record.link else ""
                key_parts.append(f"url:{url}")
            
            if key_parts:
                key = "|".join(key_parts)
                
                if key not in duplicates_map:
                    duplicates_map[key] = []
                duplicates_map[key].append(record_info)
        
        except Exception as e:
            print(f"Warning: Error processing record {record_info.record_uid}: {str(e)}")
            continue
    
    duplicate_groups = {k: v for k, v in duplicates_map.items() if len(v) > 1}
    
    if duplicate_groups:
        print(f"\nFound {len(duplicate_groups)} duplicate group(s):")
        print("=" * 50)
        
        total_duplicates = 0
        for i, (key, records) in enumerate(duplicate_groups.items(), 1):
            total_duplicates += len(records)
            print(f"\nDuplicate Group {i} ({len(records)} records):")
            print("-" * 50)
            
            first_record = vault.vault_data.load_record(records[0].record_uid)
            print(f"Common attributes:")
            if match_title:
                print(f"  Title: {first_record.title}")
            if match_login and isinstance(first_record, vault_record.PasswordRecord):
                print(f"  Username: {first_record.login or '(empty)'}")
            if match_url and isinstance(first_record, vault_record.PasswordRecord):
                print(f"  URL: {first_record.link or '(empty)'}")
            
            print(f"\nDuplicate records:")
            for record_info in records:
                record = vault.vault_data.load_record(record_info.record_uid)
                print(f"  - {record.title}")
                print(f"    UID: {record_info.record_uid}")
                print(f"    Type: {record_info.record_type}")
                if isinstance(record, vault_record.PasswordRecord):
                    print(f"    Username: {record.login or '(empty)'}")
                    print(f"    URL: {record.link or '(empty)'}")
                print()
        
        print("=" * 50)
        print(f"\nSummary:")
        print(f"  Total duplicate groups: {len(duplicate_groups)}")
        print(f"  Total duplicate records: {total_duplicates}")
        print(f"  Potential records to remove: {total_duplicates - len(duplicate_groups)}")
        print("\nNote: Review duplicates carefully before deletion.")
        print("Use delete_record.py to remove unwanted duplicates.")
    else:
        print("\nNo duplicate records found!")
        print("Your vault is clean.")
    
    print("-" * 50)
    

JavaScript SDK

関数: 近日公開