次の方法で共有


エラー レポートの概念

Windows PowerShell には、エラーを報告するための 2 つのメカニズムが用意されています。エラー 終了するためのメカニズムと、で終了しないエラーをするための別のメカニズムです。 コマンドレットを実行しているホスト アプリケーションが適切な方法で対応できるように、コマンドレットでエラーを正しく報告することが重要です。

コマンドレットは、System.Management.Automation.Cmdlet.ThrowTerminatingError* メソッドを呼び出す必要があります。 コマンドレットは、System.Management.Automation.Cmdlet.WriteError メソッドを呼び出して、コマンドレットが入力オブジェクトの処理を続行できる場合に、終了しないエラーを報告する必要があります。 どちらの方法でも、ホスト アプリケーションがエラーの原因を調査するために使用できるエラー レコードが提供されます。

次のガイドラインを使用して、エラーが終了エラーか非終了エラーかを判断します。

  • コマンドレットが現在のオブジェクトの処理を続行できず、その内容に関係なくそれ以上の入力オブジェクトが正常に処理されなくなると、エラーは終了エラーになります。

  • コマンドレットの内容に関係なく、現在のオブジェクトまたはその他の入力オブジェクトの処理を続行しない場合、エラーは終了エラーです。

  • オブジェクトを受け入れない、または返さないコマンドレットで発生した場合、または 1 つのオブジェクトのみを受け入れるか返すコマンドレットで発生した場合、エラーは終了エラーです。

  • コマンドレットで現在のオブジェクトとその他の入力オブジェクトの処理を続行する場合、エラーは終了しないエラーです。

  • エラーは、特定の入力オブジェクトまたは入力オブジェクトのサブセットに関連する場合、終了しないエラーです。

こちらもご覧ください

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

Windows PowerShell エラー レコード

Windows PowerShell コマンドレット の作成