New InvalidOperationException

New-InvalidOperationException

SYNOPSIS

Creates and throws or returns an invalid operation exception.

SYNTAX

New-InvalidOperationException [-Message] <String> [[-ErrorRecord] <ErrorRecord>] [-PassThru]
 [<CommonParameters>]

DESCRIPTION

Creates and throws or returns an invalid operation exception.

EXAMPLES

EXAMPLE 1

try
{
    Start-Process @startProcessArguments
}
catch
{
    New-InvalidOperationException -Message 'My error message' -ErrorRecord $_
}

Creates and throws an invalid operation exception with the message 'My error message' and includes the exception that caused this terminating error.

EXAMPLE 2

$errorRecord = New-InvalidOperationException -Message 'My error message' -PassThru

Creates and returns an invalid operation exception with the message 'My error message'.

PARAMETERS

-ErrorRecord

The error record containing the exception that is causing this terminating error.

Type: ErrorRecord
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Message

The message explaining why this error is being thrown.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

If specified, returns the error record instead of throwing it.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

None. If the PassThru parameter is not specified the command throws an error record.

System.InvalidOperationException. If the PassThru parameter is specified the command returns an error record.

NOTES

RELATED LINKS