KEPMエージェントコマンド

KEPMエージェント関連操作のコマンド情報

概要

ここでは、KEPMエージェントを管理するKeeperコマンダーのコマンドを扱います。エージェントはエンドポイントに導入され、KEPMシステムと通信して特権昇格ポリシーを適用します。これらのコマンドで、管理者はエージェントの状態確認、設定変更、エージェントに紐づくリソースコレクションの管理が行えます。

このセクションで扱うコマンドは以下のとおりです。

• エージェント一覧コマンド

• エージェント編集コマンド

• エージェント削除コマンド

• エージェントのコレクション表示コマンド

使い方

pedm agent command [--options] または pedm a command [--options]

別名: a

---

エージェント一覧コマンド

登録済みのKEPMエージェントを、エージェントUID、マシン名、デプロイ割り当て、状態、作成日を含む詳細とともに表示します。KEPMエージェントが導入された全エンドポイントの概要を確認できます。

DotNet CLI

コマンド: epm-agent list

例:

My Vault > epm-agent list

コマンド: epm-agent view

パラメータ:

パラメータ	型	必須	デフォルト	説明
(positional)	String	はい	—	エージェントUID

例:

My Vault > epm-agent view abc123uid

DotNet SDK

関数:

// Get all agents
IEnumerable<EpmAgent> allAgents = plugin.Agents.GetAll();
// Get a single agent by UID
EpmAgent agent = plugin.Agents.GetEntity(agentUid);

Power Commander

コマンド: Get-KeeperEpmAgentList

別名: kepm-agent-list

例:

PS > Get-KeeperEpmAgentList

AgentUid               MachineName                                 Deployment                Disabled Created             Modified
--------               -----------                                 ----------                -------- -------             --------
3rbun_JdbTQ-LewN_pwS1g 0oWfLBXW5E6ERvpSPdTmOiaZ5rl83esyiFyO-E5NRgs ServiceNow                False    2026-01-28 15:07:47 2026-02-03 07:13:44
680p8dW43xugzV_YSnGncg KENzZzzdr1PUB0ktHY9lZSU3zDyBqxw5EJ2yS1WrxYw KEPM Test Team            False    2026-03-13 08:32:02 2026-03-26 09:34:40
A2kT6arXQc9YP9805zPXUw OIaS7LT8dyxy53P0jCTWrY1iKr-hKUQWLHz7biBo3SU Jira PEDM Command         False    2025-11-10 11:06:38 2026-01-02 05:52:40

コマンド: Get-KeeperEpmAgent

別名: kepm-agent-view

パラメータ:

パラメータ	説明
-AgentUidOrName	エージェントUIDまたはマシン名 (大文字小文字を区別しない)

例:

PS > Get-KeeperEpmAgent 3rbun_JdbTQ-LewN_pwS1g
Agent: 0oWfLBXW5E6ERvpSPdTmOiaZ5rl83esyiFyO-E5NRgs
  UID: 3rbun_JdbTQ-LewN_pwS1g
  Status: Active
  Deployment: XUflUP3Utcr4j83o8sMRKg
  Created: 2026-01-28 15:07:47
  Modified: 2026-02-03 07:13:44

Python CLI

コマンド: pedm agent list

別名: pedm a l, pedm a list

フラグ:

フラグ	説明
-v, --verbose	稼働状態やプロパティを含む詳細情報の表示
--format	出力形式 (json、csv、tableのいずれか)
--output	指定ファイルへの保存

例:

My Vault> pedm agent list

Agent UID: agent_abc123
Machine Name: SERVER-001
Deployment: Production
Disabled: False
Created: 2024-10-20

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

plugin = admin_plugin.PedmPlugin(enterprise_loader)
agent_list = plugin.agents.get_all_entities()

エージェント編集コマンド

KEPMエージェントの有効/無効の切り替えやデプロイ間の移動など、エージェントの構成を変更します。エンドポイントでエージェントを再インストールせずに、管理者が設定を更新できます。

DotNet CLI

コマンド: epm-agent update

パラメータ:

パラメータ	説明
(positional)	1つ以上のエージェントUID
--deployment	エージェントを割り当てるデプロイUID
--enable	on で有効化、off で無効化

例:

My Vault > epm-agent update abc123uid --enable off

DotNet SDK

関数:

public async Task<ModifyStatus> ModifyAgents(
    IEnumerable<UpdateAgent> updateAgents = null,
    IEnumerable<string> removeAgents = null)

Power Commander

コマンド: Update-KeeperEpmAgent

別名: kepm-agent-edit

パラメータ:

パラメータ	説明
-AgentUidOrName	1つ以上のエージェントUIDまたはマシン名 (大文字小文字を区別しない)。パイプライン入力に対応
-DeploymentUid	エージェントを割り当てるデプロイUID
-Enable	on または off でエージェントの有効化または無効化

例:

PS >  Update-KeeperEpmAgent "wnEWtpyWjypIgPNCLkzLVg" -Enable off
1 agent(s) updated.
  Updated: wnEWtpyWjypIgPNCLkzLVg

Python CLI

コマンド: pedm agent edit <agent> [agent...]

別名: pedm a e, pedm a edit

フラグ:

フラグ	説明
--enable	エージェントの有効化または無効化 (choices: on, off)
--deployment	指定したデプロイUIDへのエージェント移動
agent	エージェントUID (必須、複数指定可)

例:

My Vault> pedm agent edit agent_abc123 --enable on --deployment prod_deploy_123

Agent updated successfully

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

plugin = admin_plugin.PedmPlugin(enterprise_loader)

agent_id = 'agent name or uid'
deployment_id = 'deployment name or id'
deployment = plugin.deployments.get_entity(deployment_id)

agent = plugin.agents.get_entity(agent_id)

update_agents: List[admin_types.UpdateAgent] = []
update_agents.append(admin_types.UpdateAgent(
                    agent_uid=agent.agent_uid,
                    deployment_uid=deployment.deployment_uid,
                    disabled=disabled,
                ))
                
response = plugin.modify_agents(update_agents=update_agents)

エージェント削除コマンド

システムから1つ以上のKEPMエージェントを削除します。このコマンドはKEPM管理システムからエージェントの登録を恒久削除しますが、エンドポイント上のエージェントソフトウェアのアンインストールは行いません。

DotNet CLI

コマンド: epm-agent remove

パラメータ:

パラメータ	説明
(positional)	エージェントUIDまたはマシン名

例:

My Vault > epm-agent remove abc123uid

DotNet SDK

関数:

public async Task<ModifyStatus> ModifyAgents(
    IEnumerable<UpdateAgent> updateAgents = null,
    IEnumerable<string> removeAgents = null)

Power Commander

コマンド: Remove-KeeperEpmAgent

別名: kepm-agent-delete

パラメータ:

パラメータ	説明
-AgentUidOrName	エージェントUIDまたはマシン名 (大文字小文字を区別しない)
-Force	削除前の確認プロンプトを省略

例:

PS > Remove-KeeperEpmAgent -AgentUidOrName m9nS3jj77zIr2i8YrqbNow

Confirm
Are you sure you want to perform this action?
Performing the operation "Delete" on target "agent 'Q5XrmUiehExczpCJ70_fet3JFQ3PKZyi5MoLR5QWEgM'".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): y
Agent 'm9nS3jj77zIr2i8YrqbNow' removed.
  Removed: m9nS3jj77zIr2i8YrqbNow

Python CLI

コマンド: pedm agent delete <agent> [agent...]

別名: pedm a delete

フラグ:

フラグ	説明
--force	確認プロンプトを出さずに実行
agent	エージェントUID (必須、複数指定可)

例:

My Vault> pedm agent delete agent_old123 --force

Agent deleted successfully

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

plugin = admin_plugin.PedmPlugin(enterprise_loader)

agent_id = 'agent name or uid'
agent = plugin.agents.get_entity(agent_id)

response = plugin.modify_agents( remove_agents=[agent.agent_uid])

エージェントのコレクション表示コマンド

特定のエージェントに紐づくリソースコレクションを表示します。エージェントで検出・登録されたリソースタイプ (OSビルド、アプリケーション、ユーザーアカウントなど)をすべて表示します。

DotNet CLI

コマンド: epm-agent collection

パラメータ:

パラメータ	説明
(positional)	エージェントUID
--type	結果を絞り込むコレクションタイプ番号
--verbose	グループ化された件数の代わりに、各コレクションのタイプ、UID、デコード済みJSON値を表示

コレクションタイプ:

値	名前
0	OSビルド
1	アプリケーション
2	ユーザーアカウント
3	グループアカウント
4	OSバージョン

例:

My Vault > epm-agent collection abc123uid

DotNet SDK

関数:

// Get collection UIDs linked to an agent (filter by CltAgent link type)
var collectionUids = plugin.CollectionLinks
    .GetLinksForObject(agent.AgentUid)
    .Where(link => link.LinkType == (int)PEDM.CollectionLinkType.CltAgent)
    .Select(link => link.CollectionUid);

// Resolve each collection UID
foreach (var uid in collectionUids)
{
    EpmCollection collection = plugin.Collections.GetEntity(uid);
    // collection.CollectionType → 0=OsBuild, 1=Application, 2=UserAccount, 3=GroupAccount, 4=OsVersion
    // collection.CollectionData → decrypted JSON bytes
}

Power Commander

コマンド: Get-KeeperEpmAgentCollection

別名: kepm-agent-collection

パラメータ:

パラメータ	説明
-AgentUid	エージェントUIDまたはマシン名
-CollectionType	結果を絞り込む任意のコレクションタイプ番号
-CollectionVerbose	グループ化された件数の代わりに、各コレクションのタイプ、UID、デコード済みJSON値を表示

コレクションタイプ:

値	名前
0	OSビルド
1	アプリケーション
2	ユーザーアカウント
3	グループアカウント
4	OSバージョン

例:

PS > Get-KeeperEpmAgentCollection xerWlrlsaF_YLdHDx75c-g

CollectionType    Count
--------------    -----
OS Build (1)          1
User Account (3)    137
Group Account (4)   164

Python CLI

コマンド: pedm agent collection <agent>

別名: pedm a c, pedm a collection

フラグ:

フラグ	説明
-v, --verbose	コレクションの値を含む詳細情報の表示
--type	コレクションタイプによる絞り込み (整数)
--format	出力形式 (json、csv、tableのいずれか)
--output	指定ファイルへの保存
agent	エージェントUID (必須)

例:

My Vault> pedm agent collection agent_abc123

Collection Type: OS_BUILD (1)
Count: 3

Collection Type: APPLICATION (2)
Count: 12

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

plugin = admin_plugin.PedmPlugin(enterprise_loader)

agent_id = 'agent name or uid'
agent = plugin.agents.get_entity(agent_id)

resource_uids = {x.collection_uid for x in plugin.storage.collection_links.get_links_by_object(agent.agent_uid)}
collections = [plugin.collections.get_entity(x) or x for x in resource_uids]