レコード共有コマンド

レコード共有コマンドの補足説明

概要

share-record コマンドで次のアクションが利用できます。

grant - 指定したレコードを指定ユーザーに対して共有し、権限を付与または変更する。
revoke - 現在のレコード共有を取り消す。
transfer-ownership - 所有権を指定ユーザーに移す。
cancel - ユーザーとのすべての共有を取り消す。

レコードへのアクセスをユーザーに付与するために使います。共有権や編集権を与えられます。一定期間後、または指定日時で自動的に共有を終了するよう制限することもできます。

DotNet CLI

コマンド: share-record

操作:

share : レコードをユーザーと共有する

フラグ:

-s, --share (bool、省略可)
- 受信者が他者にレコードを再共有できるようにする。
- 例: --share true
-w, --write (bool、省略可)
- 受信者がレコードを変更できるようにする。
- 例: --write true
--expire-at (string、省略可)
- 共有が期限切れになる日時を指定する。
- 形式: YYYY-MM-DD HH:mm:SS (ISO)。
- 例: --expire-at "2025-09-30 23:59:00"
--expire-in (string、省略可)
- 共有の相対的な有効期限を設定する。
- 形式: mi|h|d|mo|y
  - mi = 分
  - h = 時間
  - d = 日
  - mo = 月
  - y = 年
- 例: --expire-in 7d (7日後に期限切れ)
-e, --email (string、必須)
- 受信者 (ピアアカウント) のメールアドレス。
- 例: --email [email protected]
record (位置引数、必須)
- 共有するレコードのパスまたはUID。
- 例: MyPasswords/Bank または 9xL2c6aBc1234

例:

My Vault> share-record share <uidaaabbcc11221uuuid> --write=true --share=true --expire-at "2025-09-30
 23:59:00" --email="[email protected]"

DotNet SDK

メソッド:

public async Task ShareRecordWithUser(
    string recordUid, 
    string username, 
    IRecordShareOptions options)

引数:

recordUid - ユーザーと共有するレコードのUID
username - 共有先ユーザーのメールアドレス
IRecordShareOptions - 共有のオプション/権限
IRecordShareOptions
- CanEdit - Boolean - 共有先ユーザーが当該レコードを編集できるかどうか
- CanShare - Boolean - 共有先ユーザーが当該レコードを再共有できるかどうか
- Expiration - DateTimeOffset - ユーザーがレコードにアクセスできる共有の有効期間。期限に達すると、当該ユーザーへの共有は無効になる。

PowerCommander

コマンド: Grant-KeeperRecordAccess

エイリアス: kshr

フラグ:

-Record : 共有するレコードのUID。
-User : 共有先ユーザーのメールアドレス。
-CanEdit : ユーザーに レコードの管理 権限を付与する。
-CanShare : ユーザーに ユーザーの管理 権限を付与する。
-ExpireIn : 相対的な有効期限 (例: 数値と単位)。
-ExpireAt : 期限切れ日時 (日時オブジェクト)。

例:

PS > Grant-KeeperRecordAccess -Record record_uid -User "[email protected]" -CanShare -ExpireIn 5
Record "Example Record" was shared with user@example.com

Python CLI

コマンド: share-record --action=<> --email=<email>

パラメーター:

record : 共有するレコードの <RECORD_UID>
-e, --email : アクセスを付与するユーザーのメールアドレス
-a, --action : grant、revoke、owner、cancel - レコードに対する操作

オプション:

-s, --share : ユーザーがレコードを共有できるようにする
-w, --write : ユーザーがレコードを編集できるようにする
-R, --recursive : 共有フォルダ階層にコマンドを適用する
--expire-at : 共有の期限: "never" または ISO 日時 "YYYY-MM-DD hh:mm:ss"
--expire-in : 共有の期限: "never" または期間 <NUMBER>[(m)inutes | (h)ours | (d)ays | (y)ears]
--dry-run : 権限の変更内容を表示するだけで適用しない
--contact-only : 既知の連絡先のみと共有し、他ドメインの一致する連絡先をプロンプトで選ぶ
-f, --force : プロンプトを省略する

例:

My Vault> share-record -a='grant' -e='[email protected]' -s -w --expire-in=30d af9ed1c8_d2b4_43a3_a459
Record "af9ed1c8_d2b4_43a3_a459" access permissions has been granted to user '[email protected]'

Python SDK

コマンド:

request = shares_management.RecordShares.prep_request(
    vault=vault,
    emails=[user_email],
    action=shares_management.ShareAction.GRANT.value,
    uid_or_name=record_uid,
    share_expiration=share_expiration,
    dry_run=False,
    enterprise=enterprise_data,
    enterprise_access=False,
    recursive=False,
    can_edit=can_edit,
    can_share=can_share,
)

# リクエストを送信
shares_management.RecordShares.send_requests(vault, [request])

指定ユーザーとのすべての共有を解除するために使います。

DotNet CLI

コマンド: share-record

操作:

cancel : ユーザーとのレコード共有をすべて取り消す

フラグ:

-e, --email (string、必須)
- 受信者 (ピアアカウント) のメールアドレス。
- 例: --email [email protected]

例:

Vault> share-record cancel [email protected]
Do you want to cancel all shares with user "[email protected]"? (Yes/No) : yes

DotNet SDK

メソッド:

Task CancelSharesWithUser(string username);

引数:

username - すべての共有を解除する相手のユーザー名

例外:

Authentication.KeeperApiException

PowerCommander

コマンド: Revoke-KeeperSharesWithUser -User [-Confirm]

エイリアス: kcancelshare

パラメーター:

パラメーター

必須

説明

User

はい

すべての共有を解除する相手のユーザーのメールアドレス。

Confirm

いいえ

既定では PowerShell が確認を求める (影響が大きい操作)。-Confirm:$false で確認を省略する。

例:

PowerCommander> Revoke-KeeperSharesWithUser -User [email protected]
Confirm
Are you sure you want to perform this action?
Performing the operation "Cancel" on target "all record shares with user"[email protected]"".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): y
All record shares with user "[email protected]" have been cancelled.

Python CLI

コマンド: share-record

パラメーター:

record : 共有するレコードの <RECORD_UID>
-e, --email : アクセスを付与するユーザーのメールアドレス
-a, --action : grant、revoke、owner、cancel - レコードに対する操作

例:

Vault> share-record --action=cancel [email protected] <record_uid>

Python SDK

コマンド:

request = shares_management.RecordShares.prep_request(
    vault=vault,
    emails=[user_email],
    action=shares_management.ShareAction.CANCEL.value,
    uid_or_name=record_uid,
    share_expiration=share_expiration,
    dry_run=False,
    enterprise=enterprise_data,
    enterprise_access=False,
    recursive=False,
    can_edit=can_edit,
    can_share=can_share,
)

# リクエストを送信
shares_management.RecordShares.send_requests(vault, [request])

ユーザーに対するレコードへのアクセスを取り消すために使います。

DotNet CLI

コマンド: share-record

操作:

revoke : ユーザーからレコード共有アクセスを取り消す

フラグ:

-e, --email (string、必須)
- 受信者 (ピアアカウント) のメールアドレス。
- 例: --email [email protected]
record (位置引数、必須)
- 共有するレコードのパスまたはUID。
- 例: MyPasswords/Bank または 9xL2c6aBc1234

例:

My Vault> share-record revoke uidaabbcc22556tbuid --email="[email protected]"

DotNet SDK

メソッド:

Task RevokeShareFromUser(string recordUid, string username);

引数:

recordUid - ユーザーから取り消すレコードのUID
username - 共有を取り消す相手ユーザーのメールアドレス

PowerCommander

コマンド: Revoke-KeeperRecordAccess

フラグ:

-Record : レコードのUID
-User : 共有先ユーザーのメールアドレス

例:

PS > Revoke-KeeperRecordAccess adscsvv1314dca -User [email protected]                    
Record "some_record" share has been removed from <user>

Python CLI

コマンド: share-record

パラメーター:

record : 共有するレコードの <RECORD_UID>
-e, --email : アクセスを付与するユーザーのメールアドレス
-a, --action : grant、revoke、owner、cancel - レコードに対する操作

オプション:

-s, --share : ユーザーがレコードを共有できるようにする
-w, --write : ユーザーがレコードを編集できるようにする
-R, --recursive : 共有フォルダ階層にコマンドを適用する
--expire-at : 共有の期限: "never" または ISO 日時 "YYYY-MM-DD hh:mm:ss"
--expire-in : 共有の期限: "never" または期間 <NUMBER>[(m)inutes | (h)ours | (d)ays | (y)ears]
--dry-run : 権限の変更内容を表示するだけで適用しない
--contact-only : 既知の連絡先のみと共有し、他ドメインの一致する連絡先をプロンプトで選ぶ
-f, --force : プロンプトを省略する

例:

My Vault> share-record -a='revoke' -e='[email protected]' <record_uid>
access permissions has been revoked from user '[email protected]'

Python SDK

コマンド:

request = shares_management.RecordShares.prep_request(
    vault=vault,
    emails=[user_email],
    action=shares_management.ShareAction.REVOKE.value,
    uid_or_name=record_uid,
    share_expiration=share_expiration,
    dry_run=False,
    enterprise=enterprise_data,
    enterprise_access=False,
    recursive=False,
    can_edit=can_edit,
    can_share=can_share,
)

# リクエストを送信
shares_management.RecordShares.send_requests(vault, [request])

レコードの所有者権限をユーザーに移すために使います。

DotNet CLI

コマンド: share-record

操作:

transfer : レコードを移す / レコードの所有権を変更する。

フラグ:

-e, --email (string、必須)
- 受信者 (ピアアカウント) のメールアドレス。
- 例: --email [email protected]
record (位置引数、必須)
- 共有するレコードのパスまたはUID。
- 例: MyPasswords/Bank または 9xL2c6aBc1234

例:

My Vault> share-record transfer aabbcc2266hyy --email="[email protected]"

DotNet SDK

メソッド:

Task TransferRecordToUser(string recordUid, string username)

引数:

recordUid - ユーザーと共有するレコードのUID。
username - レコードを共有する相手ユーザーのメールアドレス。

例外:

KeeperApiException

PowerCommander

コマンド: Move-KeeperRecordOwnership

フラグ:

-Record : 共有するレコードのUID。
-User : 共有先ユーザーのメールアドレス

例:

PS > Move-KeeperRecordOwnership record_uid -User [email protected]
Record "<some record title>" was transfered to [email protected]
The new record owner can edit or remove your access to this record.

Python CLI

コマンド: share-record

パラメーター:

record : 共有するレコードの <RECORD_UID>
-e, --email : アクセスを付与するユーザーのメールアドレス
-a, --action : grant、revoke、owner、cancel - レコードに対する操作

オプション:

-s, --share : ユーザーがレコードを共有できるようにする
-w, --write : ユーザーがレコードを編集できるようにする
-R, --recursive : 共有フォルダ階層にコマンドを適用する
--expire-at : 共有の期限: "never" または ISO 日時 "YYYY-MM-DD hh:mm:ss"
--expire-in : 共有の期限: "never" または期間 <NUMBER>[(m)inutes | (h)ours | (d)ays | (y)ears]
--dry-run : 権限の変更内容を表示するだけで適用しない
--contact-only : 既知の連絡先のみと共有し、他ドメインの一致する連絡先をプロンプトで選ぶ
-f, --force : プロンプトを省略する

例:

My Vault> share-record -a='owner' -e='[email protected]' record_uid

Python SDK

コマンド:

request = shares_management.RecordShares.prep_request(
    vault=vault,
    emails=[user_email],
    action=shares_management.ShareAction.OWNER.value,
    uid_or_name=record_uid,
    share_expiration=share_expiration,
    dry_run=False,
    enterprise=enterprise_data,
    enterprise_access=False,
    recursive=False,
    can_edit=can_edit,
    can_share=can_share,
)

# リクエストを送信
shares_management.RecordShares.send_requests(vault, [request])

前へ共有コマンド次へチームコマンド

最終更新 1 日前

役に立ちましたか？

hashtag概要

hashtagレコードの共有

hashtagレコード共有の一括解除

hashtagレコード共有の取り消し

hashtagレコード所有権の移転

概要

レコードの共有

レコード共有の一括解除

レコード共有の取り消し

レコード所有権の移転