翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# エージェント設定ファイル
<a name="agent-file"></a>

エージェント設定ファイル (`/etc/dcv-session-manager-agent/agent.conf`Linux および macOS の場合は 、Windows `C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf` の場合は ) には、Session Manager の機能をカスタマイズするように設定できるパラメータが含まれています。希望するテキストエディタを使用して設定ファイルを手動で編集することができます。

下表にエージェント設定ファイルのパラメータを示します。


| パラメータ名 | 必須 | デフォルトの値 | [Description] (説明) | 
| --- | --- | --- | --- | 
| agent.broker\_host | はい |  | ブローカーホストの DNS 名を指定します。 | 
| agent.broker\_port | はい | 8445 | ブローカーとの通信用のポートを指定します。 | 
| agent.ca\_file | いいえ |  | tls\_strict が true に設定されている場合のみ必要です。TLS 証明書の検証に必要な証明書 (.pem) ファイルへのパスを指定します。ブローカーからエージェントに自己署名証明書をコピーしてください。 | 
| agent.init\_folder | いいえ |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html)  | Amazon DCV サーバーセッションを作成時に初期化できるカスタムスクリプトを保存するために使用するフォルダー (ホストサーバーにある) へのパスを指定します。絶対パスを指定する必要があります。このフォルダはアクセス可能な状態でなければならず、ファイルは、CreateSessions API の initFile リクエストパラメータを使用するユーザーが実行できる状態でなければなりません。 | 
| agent.tls\_strict | いいえ | true | 厳密な TLS 検証を使用するかどうかを示します。 | 
| agent.software\_statement\_path | いいえ |  | デフォルトのソフトウェアステートメントが使用されていない場合にのみ必要です。ソフトウェアステートメントファイルへのパスを指定します。詳細については、「[generate-software-statement](generate-software-statement.md)」を参照してください。 | 
| agent.tags\_folder | いいえ |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html)  | タグファイルが入っているフォルダへのパスを指定します。詳細については、「[Amazon DCV サーバーをターゲットにするためのタグの使用](targeting.md)」を参照してください。 | 
| agent.autorun\_folder | いいえ |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html)  | セッションのスタートアップ時に自動的に実行できるスクリプトとアプリを保存する場合に使用するフォルダー (ホストサーバーにある) へのパスを指定します。絶対パスを指定する必要があります。このフォルダはアクセス可能な状態でなければならず、ファイルは、CreateSessions API の AutorunFile リクエストパラメータを使用するユーザーが実行できる状態でなければなりません。 | 
| agent.max\_virtual\_sessions | いいえ | -1 (制限なし) | Amazon DCV セッションマネージャーを使用して Amazon DCV サーバーで作成できる仮想セッションの最大数です。 | 
| agent.max\_concurrent\_sessions\_per\_user | いいえ | 1 | 1 名のユーザーが Amazon DCV セッションマネージャーを使用して Amazon DCV サーバーで作成できる仮想セッションの最大数です。 | 
| agent.broker\_update\_interval | いいえ | 30 | 更新されたデータをブローカーに送信するまでに待機する秒数を指定します。送信データには、Amazon DCV サーバーとホストのステータス、および更新されたセッション情報が含まれます。値が小さいほど、セッションマネージャーはエージェントが実行されているシステムで発生した変更をより認識できますが、システム負荷とネットワークトラフィックが増加します。値を高くするとシステムやネットワークの負荷は減りますが、セッションマネージャーはシステムの変更に反応しにくくなるため、120 よりも高い値は推奨されません。 | 
| agent.enable\_query\_logged\_in\_users | なし | true | Windows でログに記録されたユーザーの取得を有効にします。true の場合、実際のログインユーザーのシステムをクエリします。false の場合、「unknown」を返します。 | 
| agent.preferred\_network\_interface | いいえ |  | ホスト IP 検出に使用するネットワークインターフェイス名を指定します。例: eth0 (Linux)、 Ethernet 4 (Windows)。Linux/macOS 名では大文字と小文字が区別され、Windows 名では大文字と小文字が区別されません。指定しない場合、または指定されたネットワークインターフェイスが見つからない場合は、最初の非ループバックインターフェイスが選択されます。 | 
| log.level | いいえ | info | ログファイルの詳細レベルを指定します。以下の詳細レベルを使用できます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html)  | 
| log.directory | いいえ |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html)  | ログファイルを作成するディレクトリを指定します。 | 
| log.rotation | いいえ | daily | ログファイルのローテーションを指定します。次の値を指定できます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dcv/latest/sm-admin/agent-file.html) | 
| log.max-file-size | いいえ | 10485760 | ログファイルのサイズが指定されたサイズ (バイト) に達すると、ローテーションされます。新しいログファイルが作成され、そのファイルにさらにログイベントが記録されます。 | 
| log.rotate | いいえ | 9 | ローテーションで保持されるログファイルの最大数 ローテーションが発生してこの数に達するたびに、最も古いログファイルが削除されます。 |