> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/sharing-commands/shared-folder-commands.md). # 共有フォルダコマンド 共有フォルダ一覧およびレコード権限変更コマンドの説明 ## 概要 共有フォルダの一覧、チーム、ならびにレコード権限の変更に関するコマンドを整理し、詳細を記載しています。 1. [共有フォルダ一覧コマンド](#list-share-folder) 2. [共有フォルダ - レコード権限の変更コマンド](#share-folder-change-record-permissions-command) ## コマンド ### 共有フォルダ一覧コマンド 指定したフォルダ内、またはKeeperボルトの現在のディレクトリにある共有フォルダを一覧表示します。
DotNet CLI **コマンド:** `sf-list` **例:** ```bash My Vault> sf-list # Shared Folder UID Name # Records # Users --- ---------------------- ------------------------------- --------- ------- 1 shared_folder_uid Test-Shared-Folder 11 1 ```
DotNet SDK **関数:** ```csharp var sharedFolders = vault.SharedFolders; ```
Power Commander **コマンド:** `Get-KeeperSharedFolder` **フラグ:** * `-Uid` : 共有フォルダのUID * `-Filter` : 共有フォルダを絞り込むために使用する **例:** ```powershell PS> Get-KeeperSharedFolder Uid Name DefaultManageRecords DefaultManageUsers DefaultCanEdit DefaultCanShare UserCount RecordCount --- ---- -------------------- ------------------ -------------- --------------- --------- ----------- shared_folder_uid example_new_shared_folder True True True True 1 1 ```
Python CLI **コマンド:** `list-sf` **オプション:** * `pattern` : 共有フォルダのタイトルまたはUIDのパターン * `-h, --help` : このヘルプを表示して終了する * `--format` : `list-sf` コマンドの出力形式を指定する。指定できる値は以下のとおり。 * ***table:*** 表形式で出力する。既定では表形式 * 例: `--format table` * ***csv:*** CSV形式で出力する * 例: `--format csv` * ***json***** :** JSON形式で出力する * 例: `--format json` * `--output` : 出力をファイルに保存する。出力形式が table (`--format table`) のときは使用しない * 例: `--output ` * `--verbose, -v` : 詳細出力 **例:** ``` My Vault> list-sf # Shared Folder UID Name --- ---------------------- ----------------------------------------- 1 shared_folder_uid Test Example Folder ```
Python SDK **関数:** `find_shared_folders` ```python find_shared_folders(self, criteria: str) -> Iterable[vault_types.SharedFolderInfo] ``` **例:** ```python shared_folders = vault.vault_data.find_shared_folders(criteria=pattern) ```
### 共有フォルダ - レコード権限の変更コマンド 共有フォルダ内のレコード権限を変更します。レコードごとに付与または取り消しが可能です。
DotNet CLI **コマンド:** `sf-record` **フラグ:** * `-r, --record` : 共有フォルダ内で共有の対象とするレコード名またはレコードUID * `-s, --can-share` : 真偽値 (`true` または `false`)。`true` のとき共有権限あり。`false` のとき共有権限が削除されます * `-e, --can-edit` : 真偽値 (`true` または `false`)。`true` のとき編集権限あり。`false` のとき編集権限が削除されます * `--expire-at` : 共有の期限をISO時刻で指定: YYYY-MM-DD HH:flag\_mm:SS * `--expire-in` : 共有の相対期限: \[N]mi|h|d|mo (分 / 時間 / 日 / 月) * `--help` : このヘルプ画面を表示する * `--version` : バージョン情報を表示する * `folder name (pos. 0)` : 必須の共有フォルダ名 (位置引数 0) **例:** ```bash My Vault> sf-record record_uid # Record Title Record UID Can Edit Can Share Expiration --- ------------- ---------------------- -------- --------- ---------- 1 ABC record_uid X X 2 Gmail Account record_uid X X 3 Gmail Account record_uid X X My Vault> sf-record folder_uid --record=record_uid --expire-in=30mi My Vault> sf-record BRvqCEzmFM9rVqkmpeGs6A # Record Title Record UID Can Edit Can Share Expiration --- ------------- ---------------------- -------- --------- ---------------- 1 ABC record_uid X X 03-11-2025 18:08 2 Gmail Account record_uid X X 3 Gmail Account record_uid X X ```
DotNet SDK **メソッド:** `ChangeRecordInSharedFolder` ```csharp public async Task ChangeRecordInSharedFolder(string sharedFolderUid, string recordUid, IRecordShareOptions options) ``` **例:** ```csharp await context.Vault.ChangeRecordInSharedFolder(sf.Uid, recordUid, shareOptions); ```
Power Commander **コマンド:** `Set-KeeperSharedFolderRecordPermission` **別名:** `ksfr` **フラグ:** * `-SharedFolder` : 共有フォルダのUID、名前、またはUID/名前を含むオブジェクト * `-Record` : レコードUID、またはレコードUIDを含むオブジェクト * `-CanEdit` : 共有フォルダのメンバーがレコードを編集できるかどうか。`true`、`false`、`1`、`0` のいずれかを指定します * `-CanShare` : 共有フォルダのメンバーがレコードを再共有できるかどうか。`true`、`false`、`1`、`0` のいずれかを指定します * `-ExpireIn` : `30d` や `1h` のように、現在時刻からの相対的な期限を設定します * `-ExpireAt` : 絶対的な期限日時を設定します * `-RotateOnExpiration` : 権限が失効したときにレコードのパスワードをローテーションします。期限の設定に加え、`pamUser` ローテーションレコードが構成された共有フォルダが必要です * `-WhatIf` : 変更を加えずに、権限変更の内容をプレビューします * `-Confirm` : 権限変更の前に確認を求めます **例:** ```powershell PS> Set-KeeperSharedFolderRecordPermission -SharedFolder "shared_folder_uid" -Record "record_uid" -CanEdit false -CanShare true ```
Python CLI **コマンド:** `record-permission` **パラメーター:** * `-a`, `--action` 付与または取り消し (必須) * `folder` 変更を適用する共有フォルダのUID (必須) **オプション:** * `--dry-run` コミットせずに権限の変更内容を表示する * `--force` 確認なしで権限変更を適用する * `-R`, `--recursive` すべてのサブフォルダに権限変更を適用する * `--share-record` レコードの共有権限を変更する * `--share-folder` フォルダの共有権限を変更する * `-s`, `--can-share` レコード権限: 共有可能にする * `-d`, `--can-edit` レコード権限: 編集可能にする * **--can-edit または --can-share のいずれかが必須** * **例:** ```sh My Vault> record-permission -a grant --share-record -s -d shared_folder_uid Request to GRANT "Can Edit" & "Can Share" permission(s) in "my_share" folder only ```
Python SDK **関数:** ```python from keepersdk.vault import share_management_utils ​ result = share_management_utils.update_record_permissions( vault=vault, action=action, can_share=can_share, can_edit=can_edit, folder_uid_or_path=folder_uid_or_path, recursive=recursive, share_record=share_record, share_folder=share_folder, dry_run=dry_run, sync_after=sync_after, ) ```
### 共有フォルダへのユーザーまたはチームの追加コマンド 指定したアクセス権限で、共有フォルダにユーザーまたはチームを追加します。
DotNet CLI **コマンド:** **近日公開**
DotNet SDK **関数:** ```csharp public bool PutUserToSharedFolder(string sharedFolderUid, string userId, UserType userType, IUserShareOptions options = null) { if (!TryGetFolderByUid(sharedFolderUid, out var f)) { BatchLogger?.Invoke(Severity.Warning, $"Folder UID \"{sharedFolderUid}\" not found"); return false; } switch (f.FolderType) { case FolderType.UserFolder: BatchLogger?.Invoke(Severity.Warning, $"Folder UID \"{sharedFolderUid}\" is not a shared folder"); return false; case FolderType.SharedFolderFolder: BatchLogger?.Invoke(Severity.Information, $"Folder UID \"{sharedFolderUid}\" is a shared subfolder folder. Selecting a parent shared folder."); sharedFolderUid = f.SharedFolderUid; if (!TryGetFolderByUid(sharedFolderUid, out f)) { BatchLogger?.Invoke(Severity.Warning, $"Folder UID \"{sharedFolderUid}\" not found"); } if (f.FolderType != FolderType.SharedFolder) { BatchLogger?.Invoke(Severity.Warning, $"Folder UID \"{sharedFolderUid}\" is not a shared folder"); } break; } SharedFolderMember pendingMembership = null; if (_sharedFolderMembership.TryGetValue(sharedFolderUid, out var currentSharedFolder)) { currentSharedFolder.TryGetValue(userId, out pendingMembership); } if (pendingMembership != null) { pendingMembership.IsRemove = false; pendingMembership.Options = options; return true; } pendingMembership = new SharedFolderMember { UserId = userId, UserType = userType, IsRemove = false, Options = options, }; if (currentSharedFolder == null) { currentSharedFolder = new Dictionary(); _sharedFolderMembership.Add(sharedFolderUid, currentSharedFolder); } currentSharedFolder.Add(userId, pendingMembership); return true; } ```
Power Commander **コマンド:** `Grant-KeeperSharedFolderAccess -SharedFolder [-User ] [-Team ] [-ManageUsers ] [-ManageRecords ] [-TransferRecords ] [-AllowShareFullVault ] [-WhatIf] [-Confirm]` **フラグ:** * `-SharedFolder` : アクセスを許可する共有フォルダのUIDまたは名前 * `-User` : アクセスを許可するユーザーのメールアドレスまたはUID。`-User` または `-Team` のいずれかを指定する必要があります * `-Team` : アクセスを許可するチームのUIDまたは名前。`-User` または `-Team` のいずれかを指定する必要があります * `-ManageUsers` : 共有フォルダ内のユーザーを管理する権限を付与します * `-ManageRecords` : 共有フォルダ内のレコードを管理する権限を付与します * `-TransferRecords` : 共有フォルダ内でレコードの所有権を移管する権限を付与します * `-AllowShareFullVault` : 共有フォルダ内だけでなく、ボルト全体からレコードを共有する権限を付与します * `-WhatIf` : 実際には実行せずに、コマンドレット実行時の動作をプレビューします * `-Confirm` : コマンドレットの実行前に確認を求めます **例:** ```powershell PS> Grant-KeeperSharedFolderAccess -SharedFolder "Marketing" -User "john.doe@company.com" PS> Grant-KeeperSharedFolderAccess -SharedFolder "Finance" -User "jane.smith@company.com" -ManageUsers $true -ManageRecords $true ```
Python CLI **コマンド:** **近日公開**
Python SDK **関数:** **近日公開**
### 共有フォルダからのユーザーまたはチームの削除コマンド 共有フォルダからユーザーまたはチームを削除します。
DotNet CLI **コマンド:** **近日公開**
DotNet SDK **関数:** ```csharp public async Task RemoveUserFromSharedFolder(string sharedFolderUid, string userId, UserType userType) { var sharedFolder = this.GetSharedFolder(sharedFolderUid); var perm = sharedFolder.UsersPermissions.FirstOrDefault(x => x.UserType == userType && (string.Equals(x.Uid, userId, StringComparison.InvariantCulture) || string.Equals(x.Name, userId, StringComparison.InvariantCultureIgnoreCase))); if (perm == null) { return; } var request = new SharedFolderUpdateV3Request { SharedFolderUid = ByteString.CopyFrom(sharedFolder.Uid.Base64UrlDecode()), EncryptedSharedFolderName = ByteString.CopyFrom(CryptoUtils.EncryptAesV1(Encoding.UTF8.GetBytes(sharedFolder.Name), sharedFolder.SharedFolderKey)), ForceUpdate = true, }; { var ap = this.ResolveSharedFolderAccessPath(Auth.Username, sharedFolderUid, true); if (ap != null && ap.UserType == UserType.Team) { request.FromTeamUid = ByteString.CopyFrom(perm.Uid.Base64UrlDecode()); } } if (userType == UserType.User) { request.SharedFolderRemoveUser.Add(perm.Name); } else { request.SharedFolderRemoveTeam.Add(ByteString.CopyFrom(perm.Uid.Base64UrlDecode())); } var response = await Auth.ExecuteAuthRest("vault/shared_folder_update_v3", request); foreach (var arr in (new[] { response.SharedFolderRemoveUserStatus })) { var failed = arr?.FirstOrDefault(x => x.Status != "success"); if (failed != null) { throw new VaultException($"Remove User \"{failed.Username}\" from Shared Folder \"{sharedFolder.Name}\" error: {failed.Status}"); } } foreach (var arr in (new[] { response.SharedFolderRemoveTeamStatus })) { var failed = arr?.FirstOrDefault(x => x.Status != "success"); if (failed != null) { var uid = failed.TeamUid.ToArray().Base64UrlEncode(); throw new VaultException($"Remove Team \"{uid}\" from Shared Folder \"{sharedFolder.Name}\" error: {failed.Status}"); } } await SyncDown(); } ```
Power Commander **コマンド:** `Revoke-KeeperSharedFolderAccess -SharedFolder [-User ] [-Team ] [-Force] [-WhatIf] [-Confirm]` **フラグ:** * `-SharedFolder` : アクセスを許可する共有フォルダのUIDまたは名前 * `-User` : アクセスを許可するユーザーのメールアドレスまたはUID。`-User` または `-Team` のいずれかを指定する必要があります * `-Team` : アクセスを許可するチームのUIDまたは名前。`-User` または `-Team` のいずれかを指定する必要があります * `-Force` : 確認プロンプトなしでアクセスを取り消します * `-WhatIf` : 実際には実行せずに、コマンドレット実行時の動作をプレビューします * `-Confirm` : コマンドレットの実行前に確認を求めます **例:** ```powershell PS> Grant-KeeperSharedFolderAccess -SharedFolder "Marketing" -User "john.doe@company.com" PS> Grant-KeeperSharedFolderAccess -SharedFolder "Finance" -User "jane.smith@company.com" -ManageUsers $true -ManageRecords $true ```
Python CLI **コマンド:** **近日公開**
Python SDK **関数:** **近日公開**
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.keeper.io/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/sharing-commands/shared-folder-commands.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.