PEDM Agentコマンド

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

概要

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

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

• Agent Listコマンド

• Agent Editコマンド

• Agent Deleteコマンド

• Agent Collectionコマンド

使い方

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

エイリアス: a

---

Agent Listコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

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()

Agent Editコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

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)

Agent Deleteコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

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])

Agent Collectionコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

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]