KEPMデプロイコマンド

KEPMデプロイ関連操作のコマンド情報

概要

ここでは、KEPMエージェントのデプロイを管理するKeeperコマンダーのコマンドを取り扱います。デプロイはエージェントのデプロイ構成を表し、エンドポイントでKEPMエージェントをインストールして登録するために必要なトークンを取得できます。これらのコマンドで、デプロイ構成の作成・表示・更新・削除が行えます。

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

• デプロイ一覧コマンド
• デプロイ追加コマンド
• デプロイ編集コマンド
• デプロイ削除コマンド
• デプロイトークン取得コマンド

使い方

pedm deployment command [--options] または pedm d command [--options]

エイリアス: d

---

デプロイ一覧コマンド

すべてのKEPMデプロイを、デプロイUID、名前、状態、作成日、関連エージェント数を含む詳細とともに表示します。組織全体にわたる複数のデプロイ構成の監視・管理に役立ちます。

DotNet CLI

コマンド: epm-deployment list

エイリアス: epm-dep list

例:

My Vault > epm-deployment lists

特定デプロイの詳細を取得

コマンド: epm-deployment view

エイリアス: epm-dep view

パラメータ:

パラメータ	説明
(位置引数)	デプロイUIDまたは名前 (大文字/小文字を区別しない)。
--name	代替: デプロイ名。

例:

My Vault > epm-deployment view "My Deployment"

DotNet SDK

関数:

IEnumerable<EpmDeployment> allDeployments = plugin.Deployments.GetAll();

// Get a single deployment by UID
EpmDeployment deployment = plugin.Deployments.GetEntity(deploymentUid);

Power Commander

コマンド: Get-KeeperEpmDeploymentList

エイリアス: kepm-deployment-list

例:

PS > Deployment UID         Name              Disabled Created                Modified            Agent Count
--------------              ----              -------- -------                --------            -----------
hXdaU89PDvdMxhT2oMpmTw     DEP 1                False    2026-05-04 12:13:10 2026-05-04 12:13:10           2
evd5VHCeD66VgjrGLQWj9A     DEP 2                False    2026-04-30 10:32:55 2026-04-30 10:32:55           0
VXj_WRD8Lg9JXyMDHnFODA     DEP 3                False    2026-04-22 08:40:16 2026-04-30 13:39:43           0
vvpOO8FihzHCeg4CZ-_bwA     DEP 4                False    2026-03-17 07:17:39 2026-03-17 07:17:39           0
NXpB2cmMj1D1q30U5taghg     DEP 5                False    2026-03-12 15:32:44 2026-03-12 15:32:44           0

特定デプロイの詳細情報を取得

コマンド: Get-KeeperEpmDeployment

エイリアス: kepm-deployment-view

パラメータ:

パラメータ	説明
-DeploymentUidOrName	デプロイUIDまたはデプロイ名 (大文字/小文字を区別しない)。

例:

PS > Get-KeeperEpmDeployment  hXdaU89PDvdMxhT2oMpmTw
Deployment: DEP 1
  UID: hXdaU89PDvdMxhT2oMpmTw
  Status: Active
  Created: 2026-05-04 12:13:10
  Modified: 2026-05-04 12:13:10

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

plugin = admin_plugin.PedmPlugin(enterprise_loader)
deployments = plugin.deployments.get_all_entities()

デプロイ追加コマンド

新しいKEPMデプロイ構成を作成します。エンドポイントでKEPMエージェントをインストールして登録するために利用できる、固有のデプロイトークンを生成します。デプロイ単位でエージェントを論理的にまとめられます。

DotNet CLI

コマンド: epm-deployment add

エイリアス: epm-dep add

パラメータ:

パラメータ	説明
--name	デプロイ表示名。
--spiffe-cert	SPIFFE証明書ファイルパス (.cer、.der、.pem) またはbase64urlエンコード文字列。
-f, --force	同名のデプロイが既に存在していても追加を許可。

例:

My Vault> epm-deployment add --name "Test Servers"      
Deployment 'Test Servers' added.
  Added: v1V-I5PrHXwvK82epoP_Yw

DotNet SDK

関数: ModifyDeployments

例:

public async Task<ModifyStatus> ModifyDeployments(
    IEnumerable<DeploymentDataInput> addDeployments = null,
    IEnumerable<DeploymentDataInput> updateDeployments = null,
    IEnumerable<string> removeDeployments = null)

Power Commander

コマンド: Add-KeeperEpmDeployment

エイリアス: kepm-deployment-add

パラメータ:

パラメータ	説明
-Name	デプロイ表示名。
-Force	指定時、同名のデプロイが既に存在していても追加を許可。

例:

PS > Add-KeeperEpmDeployment -Name "Example Servers"                                     
Deployment 'Example Servers' added.
  Added: QNRf1KWsxDg6YkLxJaZTbA

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

deployment_name = 'deployment name'
plugin = admin_plugin.PedmPlugin(enterprise_loader)

ec_public_key = crypto.unload_ec_public_key(enterprise_data.enterprise_info.ec_public_key)
agent_info = pedm_shared.DeploymentAgentInformation(hash_key=plugin.agent_key, peer_public_key=ec_public_key)
spiffe_cert = cert.public_bytes(serialization.Encoding.DER)

add_rq = admin_types.AddDeployment(name=deployment_name, spiffe_cert=spiffe_cert, agent_info=agent_info)
response = plugin.modify_deployments(add_deployments=[add_rq])

デプロイ編集コマンド

既存のKEPMデプロイの設定 (名前や有効/無効の状態など) を変更します。デプロイを作り直さずに、管理者がデプロイ構成を更新できます。

DotNet CLI

コマンド: epm-deployment update

エイリアス: epm-dep update

パラメータ:

パラメータ	説明
(位置引数)	デプロイUIDまたは名前 (大文字/小文字を区別しない)。
--name	新しいデプロイ表示名。
--disabled	true または false でデプロイを無効化または有効化。
--spiffe-cert	SPIFFE証明書ファイルパス (.cer、.der、.pem) またはbase64urlエンコード文字列。

例:

My Vault > epm-deployment update "Test Servers" --name "Test1 Servers"      
Deployment 'v1V-I5PrHXwvK82epoP_Yw' updated.
  Updated: v1V-I5PrHXwvK82epoP_Yw

DotNet SDK

関数: ModifyDeployments

例:

public async Task<ModifyStatus> ModifyDeployments(
    IEnumerable<DeploymentDataInput> addDeployments = null,
    IEnumerable<DeploymentDataInput> updateDeployments = null,
    IEnumerable<string> removeDeployments = null)

Power Commander

コマンド: Update-KeeperEpmDeployment

エイリアス: kepm-deployment-edit

パラメータ:

パラメータ	説明
-DeploymentUidOrName	デプロイUIDまたはデプロイ名 (大文字/小文字を区別しない)。
-Name	新しいデプロイ表示名。
-Enable	on または off でデプロイを有効化または無効化。

例:

PS > Update-KeeperEpmDeployment -DeploymentUidOrName "Example Servers" -Name "Renamed Deployment"
Deployment 'QNRf1KWsxDg6YkLxJaZTbA' updated.
  Updated: QNRf1KWsxDg6YkLxJaZTbA

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

deployment_name = 'deployment name'
plugin = admin_plugin.PedmPlugin(enterprise_loader)

deployment = plugin.deployments.get_entity(deployment_name)
spiffe_cert = cert.public_bytes(serialization.Encoding.DER)

name= 'new name'
disable = True ## or false
update_rq = admin_types.UpdateDeployment(
            deployment_uid=deployment.deployment_uid, name=name, disabled=disabled, spiffe_cert=spiffe_cert)
response = plugin.modify_deployments(update_deployments=[update_rq])

デプロイ削除コマンド

システムから1つ以上のKEPMデプロイを削除します。デプロイ構成を恒久削除するコマンドのため、特にデプロイにエージェントがまだ紐づいている場合は注意して使用してください。

DotNet CLI

コマンド: epm-deployment remove

エイリアス: epm-dep remove, epm-deployment delete

パラメータ:

パラメータ	説明
(位置引数)	デプロイUIDまたは名前 (大文字/小文字を区別しない)。
-f, --force	削除前の確認プロンプトをスキップ。

例:

My Vault> epm-deployment remove "Test1 Servers"
Do you want to delete 1 deployment(s)? [y/n]: y
  Removed: v1V-I5PrHXwvK82epoP_Yw

DotNet SDK

関数: ModifyDeployments

例:

public async Task<ModifyStatus> ModifyDeployments(
    IEnumerable<DeploymentDataInput> addDeployments = null,
    IEnumerable<DeploymentDataInput> updateDeployments = null,
    IEnumerable<string> removeDeployments = null)

Power Commander

コマンド: Remove-KeeperEpmDeployment

エイリアス: kepm-deployment-delete

パラメータ:

パラメータ	説明
-DeploymentUidOrName	デプロイUIDまたはデプロイ名 (大文字/小文字を区別しない)。
-Force	削除前の確認プロンプトをスキップ。

例:

PS > Remove-KeeperEpmDeployment "Renamed Deployment"

Confirm
Are you sure you want to perform this action?
Performing the operation "Delete" on target "deployment 'Renamed Deployment'".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): y
Deployment 'QNRf1KWsxDg6YkLxJaZTbA' deleted.
  Removed: QNRf1KWsxDg6YkLxJaZTbA

Python SDK

関数:

from keepersdk.plugins.pedm import admin_plugin

deployment_name = 'deployment name'
plugin = admin_plugin.PedmPlugin(enterprise_loader)

deployment = plugin.deployments.get_entity(deployment_name)
response = plugin.modify_deployments(remove_deployments=[deployment.uid])

デプロイトークン取得コマンド

KEPMエージェントのインストールに必要なデプロイトークンを取得します。トークンを画面に表示したりファイルに保存したりでき、必要に応じてWindows、MacOS、Linux向けエージェントインストールパッケージのダウンロードURLも表示できます。

DotNet CLI

コマンド: epm-deployment download

エイリアス: epm-dep download

パラメータ:

パラメータ	説明
(位置引数)	デプロイUIDまたは名前 (大文字/小文字を区別しない)。
--file	デプロイトークンとダウンロードURLを書き出すファイルパス (タブ区切り、UTF-8)。
--verbose	詳細出力。

例:

My Vault > epm-deployment download "Production Servers"

DotNet SDK

関数: 非対応

Power Commander

コマンド:Get-KeeperEpmDeploymentDownload

エイリアス: kepm-deployment-download

パラメータ:

パラメータ	説明
-DeploymentUidOrName	デプロイUIDまたはデプロイ名 (大文字/小文字を区別しない)。
-File	トークンとダウンロードURLを書き出す任意のパス (タブ区切り、UTF-8)。

例:

PS > Get-KeeperEpmDeploymentDownload "EPMTEST"
WARNING: The deployment token contains a private key. Treat it as a secret and do not share it insecurely.
Windows download URL    https://keepersecurity.com/pam/pedm/core/1.2.0.291/KeeperPrivilegeManagerWindows.zip
MacOS download URL      https://keepersecurity.com/pam/pedm/core/1.2.0.291/KeeperPrivilegeManagerMacOS.zip
Linux download URL      https://keepersecurity.com/pam/pedm/core/1.2.0.291/KeeperPrivilegeManagerLinux.zip
Deployment Token        keepersecurity.com:vvpOOn80jdyb8FihzHCeg4CZ-_bwA:f34Ull-C_Fqwerraoykg78012lh2O2tJOjONaE1YvNRoKU2lHy60J8090w6k

Python SDK

関数: 非対応