Neurons Bots のトラブルシューティング

PowerShell スクリプト アクションにおけるコンソール出力制限

問題: PowerShell スクリプト アクションの実行時に、スクリプトはクライアント コンピュータで正常に実行されているにもかかわらず、エラーが発生する。

原因: Ivanti Neurons for UEM で PowerShell スクリプト アクションを使用する場合、コンソールへのデータの出力に Write-Host コマンドレットが使用されることがよくあります。 この情報はアクション履歴に保存されます。 ただし、これらのコンソール メッセージに利用できるキャッシュ領域のサイズには制限があります。 キャッシュ制限を超えると、PowerShell スクリプトは引き続きクライアント コンピュータで正常に実行されているにもかかわらず、アクションがエラーを報告する可能性があります。

解決

PowerShell スクリプト アクションでのキャッシュ関連のエラーを回避するには、以下のことを考慮してください。

  • キャッシュ制限について把握しておく

    • ワークフロー プロセスのチャンク単位のデバイス数は最大250デバイス。

    • 各ステージで許可される結果は最大10 MB。

    • フルセット (250デバイス) の場合、デバイスあたりの最大出力は40 KB (10 MB / 250デバイス)。

    • デバイス1台のみを処理する場合は、10 MB の割り当て全体を使用できる。

  • スクリプトを最適化する

    • Write-Host コマンドの使用を、絶対不可欠な情報のみに限定する。

    • 詳細な出力については、別のロギング方法を使用することを検討する。

    • 大量のデータを出力するのではなく、結果を要約する。

  • スクリプトをテストする

    • 最初に少数のデバイスでスクリプトを実行して、キャッシュ制限を超えないことを確認する。

    • アクション履歴を監視し、必要に応じてスクリプトを調整する。

  • 別のレポート作成方法を使用する

    • 大量のデータ セットについては、結果をクライアント コンピュータ上のファイルに書き込み、このデータを別の方法で収集、分析することを検討する。

これらのガイドラインに従うことで、PowerShell スクリプト アクションにおけるキャッシュ関連のエラーのリスクを最小化しながら、必要な情報を収集できます。