PEDM Deploymentコマンド

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

概要

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

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

Deployment Listコマンド

Deployment Addコマンド

Deployment Editコマンド

Deployment Deleteコマンド

Deployment Downloadコマンド

使い方

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

エイリアス: d

---

Deployment Listコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

Python CLI

コマンド: pedm deployment list

エイリアス: pedm d l, pedm d list

フラグ:

フラグ	説明
-v, --verbose	すべてのエージェントUIDを含む詳細情報を表示する
--format	出力形式 - json、csv、tableのいずれか
--output	指定ファイルに保存する

例:

My Vault> pedm deployment list

Deployment UID: abc123def456
Name: Production Deployment
Disabled: False
Created: 2024-10-15
Updated: 2024-11-01
Agent Count: 15

Python SDK

機能:

from keepersdk.plugins.pedm import admin_plugin

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

Deployment Addコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

Python CLI

コマンド: pedm deployment add <name>

エイリアス: pedm d a, pedm d add

パラメータ:

name - デプロイ名 (必須)

フラグ:

フラグ	説明
-f, --force	確認プロンプトを出さずに実行する

例:

My Vault> pedm deployment add "Production Environment"

Deployment created successfully
Deployment UID: xyz789abc123

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

Deployment Editコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

Python CLI

コマンド: pedm deployment edit <deployment>

エイリアス: pedm d edit

フラグ:

フラグ	説明
--disable	デプロイの有効化または無効化 (choices: on, off)
--name	新しいデプロイ名
deployment	デプロイ名またはUID (必須)

例:

My Vault> pedm deployment edit Production --name "Production-US-East" --disable off

Deployment updated successfully

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

Deployment Deleteコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 近日公開

Power Commander

コマンド: 近日公開

Python CLI

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

エイリアス: pedm d delete

フラグ:

フラグ	説明
-f, --force	確認プロンプトを出さずに実行する
deployment	デプロイ名またはUID (必須、複数指定可)

例:

My Vault> pedm deployment delete "Old Deployment" --force

Deployment deleted successfully

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

Deployment Downloadコマンド

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

DotNet CLI

コマンド: 近日公開

DotNet SDK

メソッド: 非対応

Power Commander

コマンド: 近日公開

Python CLI

コマンド: pedm deployment download <deployment>

エイリアス: pedm d download

フラグ:

フラグ	説明
--file	デプロイトークンを指定ファイルに保存する
-v, --verbose	全プラットフォーム向けパッケージのダウンロードURLを表示する
deployment	デプロイ名またはUID (必須)

例:

My Vault> pedm deployment download Production --verbose

Windows download URL: https://keepersecurity.com/pam/pedm/packages/keeper-pedm-windows.zip
MacOS download URL: https://keepersecurity.com/pam/pedm/packages/keeper-pedm-macos.zip
Linux download URL: https://keepersecurity.com/pam/pedm/packages/keeper-pedm-linux.zip

Deployment Token: us.keepersecurity.com:abc123def456:xyz789token

Python SDK

機能: 非対応