共有コマンド

レコードおよび共有フォルダの共有に関するコマンドの説明

概要

ユーザーへの共有に関して使うコマンドの一覧です。

ボルト内のレコードの共有リンクを作成し、外部のユーザーに認証情報やレコード情報を共有するために使います。リンクは1台のデバイス/ブラウザでのみ開け、そのデバイス/ブラウザではリンクの有効期限まで再び開ける、という動作になります。

DotNet CLI

コマンド: one-time-share

フラグ:

--client : ワンタイム共有のアクション名 create 。コマンド直後の位置0の必須の位置引数。
--expire : 共有の失効までの期間 [(m)inutes|(h)ours|(d)ays。create 引数と併用する。
--help : このヘルプ画面を表示する。
--version : バージョン情報を表示する。
value pos. 0 : 実行するアクションを指定する必須の位置引数。コマンド直後の位置0に置く。受け付ける値は次のとおり。
- create – 新しいワンタイム共有を作成する
value (pos. 1) : 必須。共有するレコードのUIDまたはパス。コマンド直後の位置1に置く位置引数。

例:

My Vault > one-time-share create record_uid --expire 2m
URL: https://keepersecurity.com:443/vault/share#asdfsadf

DotNet SDK

メソッド:

public static async Task<string> CreateExternalRecordShare(this VaultOnline vault, 
        string recordUid, 
        TimeSpan expireIn, 
        string shareName = null)

引数:

vault : ボルトコンテキストで使用する。

vault.CreateExternalRecordShare(record.Uid, TimeSpan expireIn)

recordUid : 共有するレコードのUid。
TimeSpan : レコードの有効期限を設定するTimeSpanクラスのオブジェクト。
shareName : ワンタイム共有の名前。

Power Commander

コマンド: New-KeeperOneTimeShare

別名: kotsn

フラグ:

-Uid : レコードのUid
-ExpireIn : ワンタイム共有の失効までの時間 (分)
-ExpireAt : ワンタイム共有の失効日時 (日付形式)
-ShareName : ワンタイム共有のレコード名

例:

PS > New-KeeperOneTimeShare -Uid record_uid -ExpireIn 5 -ShareName "Example Share" 
https://keepersecurity.com:443/vault/share#qwertyuiopasdfghjklzxcvbnm

Python CLI

コマンド: share-create

パラメータ:

record : 共有URLを作成する対象の <RECORD_UID> またはパス
-e, --expire : 共有URLの有効期限。経過後はリンクは無効。設定できる最大期間は6ヶ月または182日

オプション:

--name : 共有URLの名前
--editable : 共有レコードの編集を許可する
--output : 共有URLの出力先 (クリップボードまたはコンソール/標準出力)

例:

My Vault> share-create --name='share_record' -e=30d record_uid
https://keepersecurity.com/vault/share#asdfsdjkkadsfdasfasdf

Python SDK

関数: create_one_time_share

from keepersdk.vault import one_time_share

url = one_time_share.create_one_time_share(
            vault=vault,
            record_uid=record_uid,
            expiration_period=expiration_period,
            name=ots_name or None,
            is_editable=is_editable,
            is_self_destruct=is_self_destruct,
        )

レコードまたはフォルダに対して作成されたワンタイム共有を一覧するために使います。レコード/フォルダUID、共有名、共有ID、作成日時、アクセス日時、失効日時、およびリンクの状態 (生成済み、アクセス済み、失効) を表示します。

DotNet CLI

コマンド: one-time-share

アクション:

実行するアクションを指定する必須の位置引数。コマンド直後の位置0に置く。受け付ける値は次のとおり。

list – レコードのワンタイム共有URLの一覧を表示する。

フラグ:

value pos. 1 : 必須。対象のレコードUIDまたはパス。コマンド直後の位置1に置く位置引数。
--client : ワンタイム共有のアクション名 list。コマンド直後の位置0の必須の位置引数。
--help : このヘルプ画面を表示する。
--version : バージョン情報を表示する。

例:

My Vault> one-time-share list record_uid  --client "Example Share" 
  #  Record UID              Record Title    Share Name   Generated          Opened             Expires          
---  ----------------------  -------------   -----------  -----------------  -----------------  -----------------    
  1  record_uid              Example Record  Share_name   8/28/2025 5:58 PM  8/28/2025 5:58 PM  8/28/2025 6:00 PM

DotNet SDK

メソッド:

public static async Task<ExternalRecordShare[]> GetExernalRecordShares(
    this VaultOnline vault, 
    string recordUid
)

引数:

vault : ボルトコンテキストで使用する。

Vault.GetExernalRecordShares(record.Uid)

recordUid : ワンタイム共有の一覧を表示するレコードのUID。

Power Commander

コマンド: Get-KeeperOneTimeShare

別名: kotsg

フラグ:

-Uid : レコードのUid

例:

PS > Get-KeeperOneTimeShare record_uid

RecordUid              RecordTitle   Owner Users Folders
---------              -----------   ----- ----- -------
record_uid             Example Record         1       1

Python CLI

コマンド: share-list

パラメータ:

record : レコード/フォルダの <UID> またはパス

オプション:

-v, --verbose : 共有IDが長い場合に省略されないよう全体を表示する。
-a, --all : 失効済みを含むすべてのワンタイム共有を表示する
-R, --recursive : サブフォルダを再帰的にたどる
--format : 出力形式 - table、json、csv

例:

My Vault> share-list record_uid --all

Record UID               Share Link Name    Share Link ID                                       Generated            Opened    Expires              Status
----------------------   -----------------  --------------------------------------------        -------------------  --------  -------------------  --------
record_uid                                  Share_link_uid                                      2025-08-06 16:54:11            2025-08-06 17:24:11  Expired

Python SDK

関数: list_one_time_shares

from keepersdk.vault import one_time_share

shares: list[one_time_share.OneTimeShare] = one_time_share.list_one_time_shares(
                vault=vault,
                record_uid=record_uids[:1000],
                include_expired=True,
            )

レコードまたはフォルダのワンタイム共有リンクを削除するために使います。

DotNet CLI

コマンド: one-time-share

フラグ:

--client : ワンタイム共有のアクション名 delete。コマンド直後の位置0の必須の位置引数。
--help : このヘルプ画面を表示する。
--version : バージョン情報を表示する。
value pos. 0 : 実行するアクションを指定する必須の位置引数。コマンド直後の位置0に置く。受け付ける値は次のとおり。
- delete – ワンタイム共有を削除する
value pos. 1 : 必須。対象のレコードUIDまたはパス。コマンド直後の位置1に置く位置引数。

例:

My Vault> one-time-share delete record_uid  --client "Example Share"

DotNet SDK

メソッド:

public static async Task DeleteExernalRecordShares(
    this VaultOnline vault, 
    string recordUid, 
    IEnumerable<string> clientId
)

引数:

VaultOnline : ボルトコンテキストで使用する。

var shares = (await context.Vault.GetExernalRecordShares(record.Uid))
Vault.DeleteExernalRecordShares(record.Uid, 
    shares.Select(x => x.ClientId))

ClientId : レコードの共有のクライアントID。

Power Commander

コマンド: Remove-KeeperOneTimeShare

別名: kotsr

フラグ:

-Uid : レコードのUid
-ShareName : 共有名の一覧

例:

PS > Remove-KeeperOneTimeShare -Uid record_uid  -ShareName "Example Share"

Python CLI

コマンド: share-remove

パラメータ: 必須

record : レコードまたはフォルダのUIDまたはパス
share : ワンタイム共有ID

例:

My Vault> share-remove record_uid shared_link_uid
One-time share "share_link_uid" is removed from record "record_uid"

Python SDK

関数: remove_one_time_share

from keepersdk.vault import one_time_share

one_time_share.remove_one_time_share(
            vault=vault,
            record_uid=record_uid,
            share_identifier=share_identifier, ## 共有ID
        )

前へフォルダコマンド次へレコード共有コマンド

最終更新 28 日前

おやすみなさい

概要

ワンタイム共有の作成コマンド

ワンタイム共有の一覧コマンド

ワンタイム共有の削除コマンド