# 設定更新ポリシータイプ

<figure><img src="/files/Men8WaNXrilZLCzAIKXV" alt=""><figcaption></figcaption></figure>

**設定更新**ポリシーを使うと、各エンドポイント上のファイルを手作業で編集せずに、構成を一括で配れます (多くの場合はプラグイン構成)。

***

### 用途

* 標準化した**プラグイン設定**の展開
* デプロイ全体でエージェント側の構成を揃えて更新する

### 仕組み (概要)

エージェントは構成プロセッサのジョブ (多くの場合**Process Configuration Policies**という名前) を実行し、`PolicyType` が **`"SettingsUpdate"`** のポリシーを見つけると、指定されたJSONを適切な場所に書き込みます。

**重要な挙動**

プラグインファイルについては、プロセッサが `Extension.SettingsJson` の内容で **ファイル全体を置き換えます** (マージではありません)。

### 手順: 設定更新ポリシーの作成 (高度なJSONから)

{% stepper %}
{% step %}
**エンドポイント特権マネージャー** → **\[ポリシー]** に移動

<figure><img src="/files/x9acflkoXrIkEhdI7Y0i" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**\[ポリシーの作成]** ボタンをクリック

ポリシー作成用のモーダルが開きます。

<figure><img src="/files/Hn1TQcU2TBuyR6pPYuN9" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**ポリシー属性の定義**

新しいポリシーには、適切で分かりやすい名前を付けます。

新規ポリシーでは、UIに表示されている**既存のポリシータイプのいずれか**を選びます (あくまで作成時のテンプレートであり、**設定更新**は後述のJSONで指定します)。

ステータスを選びます。初めてポリシーを用意するときは、**\[監視]** を推奨します。

**\[コントロールを追加]** をクリックしてコントロールを1つ以上追加し、新しいポリシーに含めたいコントロールを選びます。

ユーザーグループ、マシンコレクション、アプリケーションコレクションを指定します。
{% endstep %}

{% step %}
**ポリシーの適用対象の設定**

UIで、コレクション/ユーザー/マシン/アプリ/プラットフォームなどから、必要な**適用対象**を設定します。ポリシーをどこに効かせるかを決めます。
{% endstep %}

{% step %}
**Advanced Mode** (JSONビュー) を開く

ポリシーフォーム左下の **\[Advanced Mode]** のリンクをクリックして開きます。

<figure><img src="/files/NgeQ2U57RyINTbb1KkEx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**JSONでポリシータイプを指定**

`PolicyType` を **`"SettingsUpdate"`** に設定します。
{% endstep %}

{% step %}
**Extension**フィールドの定義

本ページの[必須のJSONフィールド](#required-json-fields)に沿って、`Extension` の各フィールドを設定します。
{% endstep %}

{% step %}
**ポリシーを保存**
{% endstep %}
{% endstepper %}

### 必須のJSONフィールド <a href="#required-json-fields" id="required-json-fields"></a>

`PolicyType` を設定します。`Extension` オブジェクトには `SettingsJson` に加え、対象の指定として `PluginName` または `TargetFile` の **どちらか一方** を含める必要があります。

#### オプションA (推奨): プラグイン名で更新

* `Extension.PluginName` = プラグイン名 (対象プラグインのJSONを更新)
* `Extension.SettingsJson` = **プラグインJSON全体** を **文字列** として
* `Extension.Action` = `Update` または `Add` (運用方針に合わせて指定)

#### オプションB (上級): パスでファイルを更新

* `Extension.TargetFile` = ファイルパス (例: `Plugins/KeeperPolicy.json`)
* `Extension.SettingsJson` = **ファイル内容全体** を **文字列** として
* `Extension.Action` = `Update` または `Add` (運用方針に合わせて指定)

## JSONの例

#### 例 (TargetFile)

```
"PolicyType": "SettingsUpdate",
"Extension": {
  "TargetFile": "Plugins/KeeperPolicy.json",
  "Action": "Update",
  "SettingsJson": "{ ...full plugin json... }"
}
```

`SettingsJson` には、書き込む内容の **全体** を文字列として含めてください。プロセッサが対象ファイルを丸ごと置き換えるため、差分や一部だけの指定にはなりません。

### エンドポイントでの検証

1. エンドポイントが適用対象の範囲に含まれていることを確認します。
2. 構成ポリシーを処理するジョブを実行またはトリガーします。
3. 対象のプラグインJSONファイル (または対象ファイル) が更新されたことを確認します。


---

# 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/endpoint-privilege-manager/policies/policy-types/advanced-policy-types/update-settings-policy-type.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.