# .NETコマンダーCLI

## 概要 <a href="#overview" id="overview"></a>

.NETコマンダーCLIは、Keeper .NET SDKを基盤に構築された高機能なコマンドラインアプリケーションです。Keeperボルトへの対話的またはスクリプトによるアクセスを可能にし、レコード管理、フォルダ操作、共有、エンタープライズ管理などを実行できます。

## コマンダーのビルドと実行 <a href="#building-and-running-commander" id="building-and-running-commander"></a>

#### リポジトリのクローン

```bash
git clone https://github.com/Keeper-Security/keeper-sdk-dotnet.git
cd keeper-sdk-dotnet
```

#### コマンダーCLIのビルド

```bash
# Commanderプロジェクトのみをビルド
dotnet build Commander/Commander.csproj

# もしくはソリューション全体をビルド
dotnet build KeeperSdk.sln
```

#### ビルド出力場所

* **.NET 8.0**: `Commander/bin/Debug/net8.0/`
* **.NET Framework 4.7.2** (Windows): `Commander/bin/Debug/net472/`

## 実行方法 <a href="#running" id="running"></a>

**プロジェクトから実行**

```bash
# LinuxまたはmacOSを使用する場合
dotnet run Commander --framework=net8.0

# Windowsを使用する場合
dotnet run Commander --framework=net472
```

## クイックスタートガイド <a href="#quick-start-guide" id="quick-start-guide"></a>

#### 初回セットアップ <a href="#first-time-setup" id="first-time-setup"></a>

1. **コマンダーの起動**\
   \
   起動すると次のような対話型プロンプトが表示されます。

   ```
   Not Logged In>
   ```
2. **Keeperへのログイン**<br>

   ```bash
   My Vault> login
   ```

   \
   プロンプトが表示されたら以下の情報を入力します。

   * メールアドレス
   * マスターパスワード
   * 2要素認証コード (有効な場合)
   * デバイス承認(必要な場合)
3. **ボルトの同期**<br>

   ```bash
   My Vault> sync-down
   # またはエイリアスを使用
   My Vault> d
   ```
4. **レコードの一覧表示**<br>

   ```bash
   My Vault> list
   # または
   My Vault> ls -l
   ```
5. **レコードの詳細を取得**<br>

   ```bash
   My Vault> get <record-uid-or-title>
   ```

### コマンド一覧 <a href="#command-reference" id="command-reference"></a>

以下は、コマンダーCLIで利用できるすべてのコマンドです [(リンク)](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference.md)。

{% hint style="info" %}
すべてのコマンドで `--help` を指定すると、使用方法を確認できます。
{% endhint %}

#### 認証コマンド <a href="#authentication-commands" id="authentication-commands"></a>

| コマンド                                                                                                                          | エイリアス | 説明                 |
| ----------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------ |
| [`login`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands.md#dotnet-cli)               |       | Keeperアカウントにログイン   |
| [`sync-down`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands.md#dotnet-cli-2) | `d`   | ボルトデータをダウンロードして復号化 |
| [`logout`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands.md#dotnet-cli-1)            |       | ログアウトしてセッションを削除    |
| [`whoami`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands.md#dotnet-cli-2)            |       | 現在のユーザー情報を表示       |

#### 生体認証コマンド <a href="#biometric-commands" id="biometric-commands"></a>

| コマンド                                                                                                                                                  | エイリアス | 説明                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ---------------------------- |
| [`biometric register`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands/biometric-login-commands.md#dotnet-cli) |       | 新しいWindows Helloキーを登録        |
| [`biometric verify`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands/biometric-login-commands.md#dotnet-cli-1) |       | 生体認証でログインを検証                 |
| [`biometric list`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands/biometric-login-commands.md#untitled)       |       | Keeperアカウントに登録されている生体認証を一覧表示 |
| [`biometric remove`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/login-commands/biometric-login-commands.md#dotnet-cli-2) |       | 現在のプラットフォームに紐づく認証情報を削除       |

#### ボルトのナビゲーションと検索 <a href="#vault-navigation-and-search" id="vault-navigation-and-search"></a>

| コマンド                                                                                                                     | エイリアス                                                                                                             | 説明                   |
| ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | -------------------- |
| [`search`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands.md#dotnet-cli) | [`list`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli-3) | ボルトを検索 (正規表現パターンに対応) |
| [`ls`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli)            |                                                                                                                   | 現在のフォルダ内容を一覧表示       |
| [`cd`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli-5)          |                                                                                                                   | 現在のフォルダを変更           |
| [`tree`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli-3)        |                                                                                                                   | フォルダ構造をツリー表示         |

#### レコード管理 <a href="#record-management" id="record-management"></a>

| コマンド                                                                                                                                          | エイリアス  | 説明                      |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------- |
| [`get`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli-4)                              |        | レコード、フォルダ、チームなどの詳細情報を取得 |
| [`add-record`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli)                         | `add`  | 新しいレコードを作成              |
| [`update-record`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli-1)                    | `edit` | 既存のレコードを更新              |
| [`rm`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli-2)                               |        | レコードを削除 (複数可)           |
| [`mv`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli-1)                               |        | レコードまたはフォルダを別の場所に移動     |
| [`record-history`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands.md#dotnet-cli-5)                   |        | レコードのバージョン履歴を表示         |
| [`record-type-info`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-type-commands.md#dotnet-cli)              | `rti`  | レコードタイプ情報を取得            |
| [`share-record`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/sharing-commands/record-share-command.md#dotnet-cli) |        | レコード共有の権限を管理            |

#### 添付ファイル管理 <a href="#attachment-management" id="attachment-management"></a>

| コマンド                                                                                                                                                 | エイリアス | 説明                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------- |
| [`download-attachment`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands/attachment-commands.md#dotnet-cli-1) |       | レコードから添付ファイルをダウンロード |
| [`upload-attachment`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands/attachment-commands.md#dotnet-cli)     |       | レコードに添付ファイルをアップロード  |
| [`delete-attachment`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-commands/attachment-commands.md#dotnet-cli-2)   |       | レコードから添付ファイルを削除     |

#### フォルダ管理 <a href="#folder-management" id="folder-management"></a>

| コマンド                                                                                                               | エイリアス | 説明            |
| ------------------------------------------------------------------------------------------------------------------ | ----- | ------------- |
| [`mkdir`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli-4) |       | 新しいフォルダを作成    |
| [`rmdir`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/folder-commands.md#dotnet-cli-2) |       | フォルダを削除       |
| `update-dir`                                                                                                       |       | フォルダのプロパティを更新 |

#### 共有フォルダ管理 <a href="#shared-folder-commands" id="shared-folder-commands"></a>

| コマンド                                                                                                | エイリアス | 説明                |
| --------------------------------------------------------------------------------------------------- | ----- | ----------------- |
| [`sf-list`](/keeperpam/jp/commander-cli/commander-installation-setup/net-developer-sdk.md#foruda)   |       | すべての共有フォルダを一覧表示   |
| [`sf-user`](/keeperpam/jp/commander-cli/commander-installation-setup/net-developer-sdk.md#foruda)   |       | 共有フォルダのユーザー権限を管理  |
| [`sf-record`](/keeperpam/jp/commander-cli/commander-installation-setup/net-developer-sdk.md#foruda) |       | 共有フォルダ内のレコード権限を管理 |

#### ゴミ箱管理 <a href="#trash-management" id="trash-management"></a>

| コマンド                                                                                                          | エイリアス | 説明               |
| ------------------------------------------------------------------------------------------------------------- | ----- | ---------------- |
| [`trash`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/trash-commands.md#commands) |       | ゴミ箱内の削除済みレコードを管理 |

#### デバイス管理 <a href="#device-management" id="device-management"></a>

| コマンド                                                                                                                                                | エイリアス | 説明              |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | --------------- |
| [`devices`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands/device-commands.md)                      |       | 他のデバイスを管理       |
| [`this-device`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands/this-device-commands.md#this-device) |       | 現在使用中のデバイス設定を管理 |

#### エンタープライズコマンド <a href="#enterprise-commands" id="enterprise-commands"></a>

| コマンド                                                                                                                                                                | エイリアス  | 説明                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------- |
| [`enterprise-get-data`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/enterprise-info-commands.md#usage-2) | `eget` | エンタープライズデータを取得    |
| [`enterprise-node`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/enterprise-node-commands.md#usage-3)     | `en`   | エンタープライズの組織ノードを管理 |
| [`enterprise-user`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/enterprise-user-commands.md#commands-4)  | `eu`   | エンタープライズユーザーを管理   |
| [`enterprise-team`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/enterprise-team-commands.md#commands-3)  | `et`   | エンタープライズチームを管理    |
| [`enterprise-role`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/enterprise-role-commands.md#commands-2)  | `er`   | エンタープライズロールを管理    |
| [`enterprise-device`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/device-approve-commands.md#dotnet-cli) | `ed`   | ユーザーデバイスを管理       |
| [`transfer-user`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/transfer-user-commands.md#dotnet-cli)      |        | ユーザーアカウントの所有権を譲渡  |
| [`audit-report`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/enterprise-management-commands/audit-alert-commands.md#dotnet-cli)         |        | 監査レポートを実行         |

#### レコードタイプ管理 <a href="#record-type-management" id="record-type-management"></a>

| コマンド                                                                                                                                      | エイリアス | 説明                       |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------ |
| [`record-type-add`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-type-commands.md#dotnet-cli-1)         |       | 新しいカスタムレコードタイプを追加        |
| [`record-type-update`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-type-commands.md#dotnet-cli-2)      |       | 既存のレコードタイプを更新            |
| [`record-type-delete`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/record-type-commands.md#dotnet-cli-3)      |       | カスタムレコードタイプを削除           |
| [`load-record-types`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/import-export-commands.md#dotnet-cli-5)     |       | JSONファイルからレコードタイプを一括読み込み |
| [`download-record-types`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/import-export-commands.md#dotnet-cli-4) |       | レコードタイプをJSONファイルにエクスポート  |

#### セキュリティとレポート <a href="#security-and-reporting" id="security-and-reporting"></a>

| コマンド                                                                                                                      | エイリアス | 説明                        |
| ------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------- |
| `password-report`                                                                                                         |       | パスワードセキュリティの包括的レポートを生成    |
| [`breachwatch`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/breachwatch-commands.md#overview) |       | BreachWatchによるセキュリティ監視を実行 |

#### その他のコマンド <a href="#other-commands" id="other-commands"></a>

| コマンド                                                                                                                         | エイリアス | 説明                       |
| ---------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------ |
| [`ksm`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/secrets-manager-commands.md#overview)        |       | Keeperシークレットマネージャー関連コマンド |
| [`one-time-share`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/sharing-commands.md#dotnet-cli-1) |       | セキュアなワンタイム共有を管理          |
| [`import`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/import-export-commands.md#dotnet-cli)     |       | JSONファイルからレコードをインポート     |
| [`clear`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands.md#dotnet-cli-4)    | `c`   | 画面をクリア                   |
| `help`                                                                                                                       | `?`   | ヘルプ情報を表示                 |
| [`quit`](/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/miscellaneous-commands.md#dotnet-cli-5)     | `q`   | コマンダーを終了                 |

### 生体認証ログインの例 <a href="#biometric-login-examples" id="biometric-login-examples"></a>

#### 生体認証でログイン <a href="#logging-in-with-biometric" id="logging-in-with-biometric"></a>

```
Connected to "keepersecurity.com".

Username: user_email
Biometric authentication successful.
Authentication completed successfully.

Syncing...
Decrypted 62 record(s)
```

#### 生体認証情報の登録 <a href="#register-biometric-credentials" id="register-biometric-credentials"></a>

このコマンドは、現在CLIでログイン中のユーザーのメールアドレスに新しいパスキーを作成します。このパスキーは、生体認証ログインをデバイスに登録した後、ログイン時の認証に使用されます。

このコマンドを使用するには、CLIでログインしている必要があります。

**備考**

1. コマンド実行後は、生体認証をデフォルトのログイン方法として使用するために、デバイスをKeeperに登録する必要があります。
2. 永続ログインが有効なデバイスでは、生体認証よりも永続ログインが優先されるため、ログイン時に生体認証は不要です。

```
My Vault> biometric register
Registering Windows Hello biometric credential...
Windows Hello credential registered successfully
Provider: Windows Hello

You can now use Windows Hello to log in to Keeper.
```

#### 生体認証情報で認証 <a href="#authenticate-biometric-credential" id="authenticate-biometric-credential"></a>

このコマンドは、保存済みの生体認証情報を使用してセッションを認証します。この機能は、生体認証によるログイン時にも同様に使用されます。

```sh
My Vault> biometric verify
Verifying Windows Hello authentication for '<user_email>' (purpose: vault)...
Windows Hello verification successful.

My Vault> biometric verify --purpose=login
Verifying Windows Hello authentication for '<user_email>' (purpose: login)...
Windows Hello verification successful.
```

#### 登録済み生体認証情報の一覧表示 <a href="#list-biometric-credential" id="list-biometric-credential"></a>

このコマンドは、指定したアカウントに登録されているすべての生体認証情報を表示します。認証デバイスタイプ、クレデンシャルID、作成日、最終使用日を含みます。

このコマンドを使用するには、CLIでログインしている必要があります。

```bash
My Vault> biometric list
Listing Windows Hello biometric credentials...


    #  Friendly Name  Provider                Created           Last Used         Status
  ---  -------------  ----------------------  ----------------  ----------------  ------
    1  Windows Hello  Windows Hello           2025-10-10 19:41  2025-10-10 19:42  Active
    2  Windows Hello  Windows Hello           2025-10-29 12:59  2025-10-29 14:14  Active
```

#### 生体認証情報の削除 <a href="#remove-biometric-credential" id="remove-biometric-credential"></a>

このコマンドは、Keeperから生体認証クレデンシャルを無効化します。削除後、Keeperプラットフォームは該当する認証情報を使用してログインを許可しなくなります。

```sh
My Vault> biometric remove
Are you sure you want to remove Windows Hello biometric credential for '<user_email>'? (y/N): y
Biometric credential removed for user: '<user_email>'
```


---

# Agent Instructions: 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:

```
GET https://docs.keeper.io/keeperpam/jp/commander-cli/commander-installation-setup/net-developer-sdk/.net-commander-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
