MID なしエージェント登録の失敗と重複するエージェント ID の修正<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } 症状 For a MID-less connected agent, the agent shows ACC-4004 error, which means that there are multiple agents using the same agent ID. For a MID-less connected agent, the agent shows ACC-4104 error, which means that there is already another agent registered using the same agent ID. For a MID-less connected agent, the agent has a registration failure. This is vague, but this re-registration process is applicable to general registration failures. エージェント登録プロセス エージェントが初めて起動すると、ホストデバイスのホスト名、MAC アドレス、およびシリアル番号に基づいてエージェント ID が生成されます。このエージェント ID は、ホストデバイスのagent_now_idファイルに保存されます。このエージェント ID はエージェントごとに一意である必要があります。エージェントは、acc.ymlで生成されたエージェント ID と登録キーを使用してインスタンスに登録します。インスタンスがエージェント登録を検証した後、インスタンスは、エージェントが ITOM クラウドサービスポッドとの永続的な接続を確立するために必要な証明書ファイルをエージェントに送り返します。エージェントはこの証明書をファイルシステムに保存し、ポッドに接続して登録プロセスを完了します。 注意:エージェント ID はエージェントごとに一意であるように意図されています。エージェントがインスタンスに登録すると、エージェントが既にそのエージェント ID で登録されている場合、インスタンスは登録をブロックします。正常に登録した後にエージェントがインスタンスから受け取る証明書には、エージェント ID が記載されています。 登録時の問題 ACC の一括展開を実行するときに、顧客が誤って agent_now_id ファイルまたは証明書ファイルをゴールデンイメージに含めてしまうことがよくあります。このゴールデンイメージからクローンが作成されると、agent_now_idファイルがコピーされてからすべてのクローンで同じエージェント ID が使用されます。agent_now_idファイルはコピーされても証明書ファイルはコピーされない場合、エージェントの登録は失敗し、エージェントが既にエージェント ID に登録されていることを示す ACC-4104 エラーがログに記録されます。登録に失敗した場合は、エージェントを再登録するために手動での介入が必要です。以下の「修復」セクションを参照してください。agent_now_idファイルがコピーされ、証明書ファイルがコピーされると、ACC-4004エラーがエラーに対してログに記録されます。ACC-4004 エラーには、複数のデバイス間で共有されているエージェント ID が含まれています。特定のエージェントIDの各ACC-4004エラーには、このエージェントIDを使用しているデバイスのホスト名が記載されるため、ユーザーはどのデバイスが同じエージェントIDを使用しているかを把握できます。複数のデバイスが同じエージェント ID を使用している場合は、エージェントがエージェント ID を再生成してインスタンスに再登録するように手動での介入が必要です。以下の「修復」セクションを参照してください。 是正処置 登録の失敗に関連する問題や重複するエージェント ID に関連する問題を解決するには、次の手順に従ってください。 インスタンスで、エージェントのエージェント ID に基づいてsn_agent_agent_registrationレコードを削除します。これは、エージェントを再登録するために必要です。エージェントを停止する登録キーをacc.ymlに入力します。登録キーは前回の登録後にクリアされており (成功または失敗に関わらず)、登録を再実行するにはキーが必要です。証明書ファイルを削除します。登録は証明書が存在しない場合にのみ行われるため、これはエージェントに再登録してもらうために必要です。agent_now_idファイルを削除します。エージェント ID の再生成は、agent_now_idファイルがまだ存在しない場合にのみ行われるため、これはエージェントに新しいエージェント ID の再生成をさせるために必要です。エージェントを起動します。エージェントは、再生成されたエージェント ID を使用して登録プロセスを実行します。 ファイルパス Windows： acc.yml:C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml証明書ファイル:C:\ProgramData\ServiceNow\agent-client-collector\config\cert\cnc\cnc_chain.crtagent_now_idファイル:C:\ProgramData\ServiceNow\agent-client-collector\cache\agent_now_id スクリプト この KB では、影響を受ける Windows デバイスで修復を実行するための PowerShell スクリプトを提供します。スクリプトはインスタンス上のsn_agent_agent_registrationレコードを削除しないため (上記のプロセスのステップ 1)、ACC アドミンがスクリプトを実行する前に削除する必要があります。 スクリプトは、SCCM などのツールで一括展開できます。 このスクリプトは、ServiceNow エージェントクライアントコレクターのエージェント ID を証明書と照合して検証し、必要に応じてエージェントを再登録します。このスクリプトは、エージェント ID が証明書の ID と一致するかどうかを確認し、一致しない場合 (または証明書が存在しない場合) 再登録を実行します。 スクリプトは、再登録が不要な次の条件で正常に終了します。 エージェントサービスが存在しません。これは、ACC がデバイスにインストールされていないことを意味します。エージェントが再生成されたエージェント ID が、証明書ファイル内のエージェント ID と一致します。これは、エージェントが既に正しいエージェント ID で登録されているため、再登録は必要ないことを意味します。 スクリプトは、次の条件でエージェントを再登録します。 証明書ファイルが存在しません。証明書ファイルがないということは、エージェントが以前に登録されていないことを意味するため、登録が必要です。新しく生成されたエージェント ID が証明書ファイルのエージェント ID と一致しません。これは、エージェントが登録されましたが、「正しくない」エージェント ID を使用していることを意味します。この状況では、エージェント ID が複数のデバイス間で共有されている可能性が高く、新しく生成されたエージェント ID を使用してエージェントを再登録する必要があります。 バックアップファイルは、プロセス中に作成されます。- agent_now_id.backup:元のエージェントIDファイルのバックアップ- cnc_chain.crt.backup:証明書ファイルのバックアップ(再登録中に削除された場合) これらのバックアップファイルは、登録が成功したことが確認された後に手動で削除できます。 スクリプトは、次のように JSON 形式の出力を返します。 { "OriginalAgentIdFileExists": true, "Timestamp": "2025-12-05 15:40:48", "OriginalAgentId": "4eca5201061a0bb1", "ErrorMessage": null, "CertAgentId": "4eca5201061a0bb1", "Success": true, "ServiceExists": true, "AgentIdsMatch": false, "RegistrationKey": "{your_registration_key}", "CertFileExists": true, "Hostname": "W22-RITM0268626", "NewAgentId": "9fbb55f93d8945c1", "RegistrationPerformed": true } これにより、元のエージェント ID、元の証明書のエージェント ID、再生成されたエージェント ID など、エージェントの登録ステータスに関する重要な情報が提供されます。 スクリプトには、登録キーである単一のパラメーターがあります。 スクリプトは、次のように呼び出すことができます。\AgentClientCollectorRegistration.ps1 -RegistrationKey "your-registration-key-here" スクリプトはアドミニストレーターとして実行する必要があります。