> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-admin-guide/v22-ja-jp/natasuku/ras-agent-noappugurdo.md).

# RAS Agent のアップグレード

ファームに Parallels RAS コンポーネントを追加する際、それらに対応する RAS エージェントをインストールします。これには、RAS 接続ブローカー、リモート デスクトップ セッション ホストエージェント、プロバイダエージェント、ゲストエージェント、リモート コンピューター システムエージェントが含まれます。エージェントの状態を確認し、必要に応じて更新できる機能に加え、エージェントの一括更新やアップグレードを行うことも可能です。

エージェントの更新が必要かどうかを確認するには、2つの方法があります。Parallels RASからの通知を待つか、ステータスを確認して手動で更新手順を開始することができます。

Parallels RASコンソールを起動すると、「エージェントのインストールまたは更新が必要です」というメッセージボックスが表示される場合があります。 このダイアログで\*\*\[はい]\*\*をクリックすると、更新手順を開始できます。その後、エージェントの更新が必要なすべてのサーバーの一覧が表示され、そのサーバーを一括更新の対象に含めるか除外するかを決定できます。選択が完了したら、画面上の指示に従ってエージェントを更新してください。

手動で手順を開始するには、RAS コンソールで **タスク** > **すべてのエージェントをアップグレード** をクリックします（このメニューは、適切なほとんどのビューで提供されます）。 また、ビュー内で右クリックして **すべてのエージェントをアップグレード** を選択することもできます。画面上の指示に従い、エージェントの更新またはアップグレードが必要なサーバーを選択してください。なお、特定のペインに表示されているすべてのサーバー上のエージェントが最新の状態である場合、このメニューオプションは無効になります。

たとえば、すべてのサイトにあるすべてのプライマリ接続ブローカーをアップグレードするには、**ファーム** > **ファーム** を選択し、**タスク** > **すべてのエージェントをアップグレード** をクリックします（または、ペイン内を右クリックして **すべてのエージェントをアップグレード** を選択します）。 サイト内のすべてのサーバー上のすべてのエージェントをアップグレードするには、**Farm** > \ を選択し、**Tasks** > **Upgrade all Agents** をクリックします。 同様に、すべての RAS セキュアゲートウェイ上のエージェントをアップグレードするには、**ファーム** > \<site> > **セキュアゲートウェイ** を選択し、同じ **タスク** > **すべてのエージェントをアップグレード** メニュー項目を使用します。その他のコンポーネントについても、まったく同じ手順を実行してください。 すべてのサーバーで同じサインイン情報を使用する場合、その入力は 1 回だけで済みます。更新プロシージャでは、最後に入力されたサインイン情報が記憶され、すべてのサーバーでそのサインイン情報の使用が試みられます。特定のサーバーでサインイン情報が機能しない場合は、再入力が求められます。

**タスク** > **すべてのエージェントをアップグレード** メニューをクリックすると、エージェントの更新またはアップグレードが必要なホストが一覧表示されるダイアログが開きます。リストの **ステータス** 列にその旨が表示され、該当するホストはアップグレード対象として事前に選択されています。 未検証のエージェントもリストに含まれますが、事前に選択されているわけではありません。それらのホスト上のエージェントもアップグレードする必要があると思われる場合は、手動で選択することができます。

**RASエージェントのアップグレード**ダイアログには、現在**ドレイン モード**にあるホストも表示されます。 これらのホストは、他のホストと同様に選択してアップグレードできます。アップグレード開始前にホストが `Drain Mode` にある場合、その `Drain Mode` 状態はアップグレードプロセス全体を通じて維持され、アップグレード完了後も有効なままとなります。

{% hint style="info" %}
**注：** テンプレート（VDI）内のエージェントを更新する場合、フルクローンとリンククローンでは更新方法が異なります。 重要な情報については、[**テンプレートのメンテナンス**](/landing/ras-admin-guide/v22-ja-jp/desukutoppuinfuravdi/vdi-no/tenpurtovdino/tenpurtonomentenansu.md) のセクションをお読みください。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-admin-guide/v22-ja-jp/natasuku/ras-agent-noappugurdo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.