Write-Error
エラー ストリームにオブジェクトを書き込みます。
構文
Write-Error
[-Message] <string>
[-Category <ErrorCategory>]
[-ErrorId <string>]
[-TargetObject <Object>]
[-RecommendedAction <string>]
[-CategoryActivity <string>]
[-CategoryReason <string>]
[-CategoryTargetName <string>]
[-CategoryTargetType <string>]
[<CommonParameters>]Write-Error
[-Exception] <Exception>
[-Message <string>]
[-Category <ErrorCategory>]
[-ErrorId <string>]
[-TargetObject <Object>]
[-RecommendedAction <string>]
[-CategoryActivity <string>]
[-CategoryReason <string>]
[-CategoryTargetName <string>]
[-CategoryTargetType <string>]
[<CommonParameters>]Write-Error
[-ErrorRecord] <ErrorRecord>
[-RecommendedAction <string>]
[-CategoryActivity <string>]
[-CategoryReason <string>]
[-CategoryTargetName <string>]
[-CategoryTargetType <string>]
[<CommonParameters>]説明
このコマンドレットは Write-Error 、終了しないエラーを宣言します。 既定では、エラー ストリームで出力と共に表示されるホスト プログラムにエラーが送信されます。
終了しないエラーを書き込むには、エラー メッセージ文字列、ErrorRecord オブジェクト、または Exception オブジェクトを入力します。 その他のパラメーター Write-Error を使用して、エラー レコードを設定します。
終了しないエラーはエラー ストリームにエラーを書き込みますが、コマンド処理は停止しません。 未終了エラーが、入力項目のコレクション内の 1 つの項目で宣言された場合、コマンドはコレクション内の他の項目の処理を続行します。
終了エラーを宣言するには、キーワード (keyword)をThrow使用します。
詳細については、「about_Throw」を参照してください。
例
例 1: RegistryKey オブジェクトのエラーを書き込む
Get-ChildItem | ForEach-Object {
if ($_.GetType().ToString() -eq "Microsoft.Win32.RegistryKey")
{
Write-Error "Invalid object" -ErrorId B1 -TargetObject $_
}
else
{
$_
}
}このコマンドは、コマンドレットが PowerShell レジストリ プロバイダーのオブジェクトやHKCU:ドライブなどのオブジェクトをMicrosoft.Win32.RegistryKey返すときGet-ChildItemにHKLM:、終了しないエラーを宣言します。
例 2: コンソールにエラー メッセージを書き込む
Write-Error "Access denied."このコマンドは、未終了エラーを宣言し、"Access denied" エラーを書き込みます。 このコマンドでは Message パラメーターを使用してメッセージを指定しますが、省略可能な Message パラメーター名は省略します。
例 3: コンソールにエラーを書き込み、カテゴリを指定する
Write-Error -Message "Error: Too many input values." -Category InvalidArgumentこのコマンドは、未終了エラーを宣言し、エラー カテゴリを書き込みます。
例 4: Exception オブジェクトを使用してエラーを書き込む
$E = [System.Exception]@{Source="Get-ParameterNames.ps1";HelpLink="https://go.microsoft.com/fwlink/?LinkID=113425"}
Write-Error -Exception $E -Message "Files not found. The $Files location doesn't contain any XML files."このコマンドでは、Exception オブジェクトを使用して、終了しないエラーを宣言します。
最初のコマンドでは、ハッシュ テーブルを使用して System.Exception オブジェクトを作成します。 例外オブジェクトを変数に $E 保存します。 ハッシュ テーブルを使用して、null コンストラクターを持つ種類のオブジェクトを作成します。
2 番目のコマンドでは、コマンドレットを Write-Error 使用して、終了しないエラーを宣言します。 Exception パラメーターの値は、変数内$Eの Exception オブジェクトです。
パラメーター
-Category
エラーのカテゴリを指定します。 既定値は NotSpecified です。 このパラメーターの有効値は、次のとおりです。
- NotSpecified
- OpenError
- CloseError
- DeviceError
- DeadlockDetected
- InvalidArgument
- InvalidData
- InvalidOperation
- InvalidResult
- InvalidType
- MetadataError
- NotImplemented
- NotInstalled
- ObjectNotFound
- OperationStopped
- OperationTimeout
- SyntaxError
- Parsererror
- PermissionDenied
- ResourceBusy
- ResourceExists
- ResourceUnavailable
- ReadError
- WriteError
- FromStdErr
- SecurityError
- ProtocolError
- ConnectionError
- AuthenticationError
- LimitsExceeded
- QuotaExceeded
- NotEnabled
エラー カテゴリの詳細については、「ErrorCategory 列挙型」を参照してください。
| Type: | ErrorCategory |
| Accepted values: | NotSpecified, OpenError, CloseError, DeviceError, DeadlockDetected, InvalidArgument, InvalidData, InvalidOperation, InvalidResult, InvalidType, MetadataError, NotImplemented, NotInstalled, ObjectNotFound, OperationStopped, OperationTimeout, SyntaxError, ParserError, PermissionDenied, ResourceBusy, ResourceExists, ResourceUnavailable, ReadError, WriteError, FromStdErr, SecurityError, ProtocolError, ConnectionError, AuthenticationError, LimitsExceeded, QuotaExceeded, NotEnabled |
| Position: | Named |
| Default value: | NotSpecified |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CategoryActivity
エラーの原因となったアクションを指定します。
| Type: | String |
| Aliases: | Activity |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CategoryReason
アクティビティによってエラーが発生した方法または理由を指定します。
| Type: | String |
| Aliases: | Reason |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CategoryTargetName
エラーが発生したときに処理されていたオブジェクトの名前を指定します。
| Type: | String |
| Aliases: | TargetName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CategoryTargetType
エラーが発生したときに処理されていたオブジェクトの種類を指定します。
| Type: | String |
| Aliases: | TargetType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ErrorId
エラーを識別する ID 文字列を指定します。 この文字列、はエラーに対して一意である必要があります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ErrorRecord
エラーを表す エラー レコード オブジェクトを指定します。 エラーを説明するオブジェクトのプロパティを使用します。
エラー レコード オブジェクトを作成するには、コマンドレットを New-Object 使用するか、自動変数の配列からエラー レコード オブジェクトを $Error 取得します。
| Type: | ErrorRecord |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exception
エラーを表す例外オブジェクトを指定します。 エラーを説明するオブジェクトのプロパティを使用します。
例外オブジェクトを作成するには、ハッシュ テーブルを使用するか、コマンドレットを New-Object 使用します。
| Type: | Exception |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Message
エラーのメッセージ テキストを指定します。 テキストにスペースまたは特殊文字が含まれる場合は、二重引用符で囲みます。 メッセージ文字列 Write-Errorをパイプでパイプすることもできます。
| Type: | String |
| Aliases: | Msg |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RecommendedAction
エラーを解決または回避するためにユーザーが実行する必要があるアクションを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetObject
エラーが発生したときに処理されていたオブジェクトを指定します。 オブジェクト、オブジェクトを含む変数、またはオブジェクトを取得するコマンドを入力します。
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
エラー メッセージを含む文字列をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。 エラー メッセージ ストリームにのみ書き込まれます。
メモ
Write-Error は自動変数の値を $? 変更しないため、終了エラー状態を通知しません。 終了エラーを通知するには、$PSCmdlet.WriteError() メソッドを使用します。
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示