Write-NonTerminatingError

SYNOPSIS

Creates and writes non-terminating error records.

SYNTAX

Write-AtlassianNonTerminatingError [[-Cmdlet] <PSCmdlet>] -Exception <Exception>
 [[-TargetObject] <Object>] -ErrorId <String> -Category <ErrorCategory>
 [<CommonParameters>]

Write-AtlassianNonTerminatingError [[-Cmdlet] <PSCmdlet>] [-Exception <Exception>]
 [-ExceptionType <String>] -Message <String> [[-TargetObject] <Object>]
 -ErrorId <String> -Category <ErrorCategory> [<CommonParameters>]

Write-AtlassianNonTerminatingError [[-Cmdlet] <PSCmdlet>] -ErrorRecord <ErrorRecord>
 [<CommonParameters>]

DESCRIPTION

Writes non-terminating errors either from an existing exception, a newly constructed exception, or an existing error record.

EXAMPLES

EXAMPLE 1

function Invoke-WriteNonTerminatingErrorExistingExample {
    [CmdletBinding()]
    param()

    Write-AtlassianNonTerminatingError `
        -Exception ([System.Exception]::new('existing-exception')) `
        -ErrorId 'Demo.WriteNonTerminatingError.Existing' `
        -Category InvalidOperation `
        -ErrorAction SilentlyContinue
}

Invoke-WriteNonTerminatingErrorExistingExample

Writes a non-terminating error from an existing exception.

EXAMPLE 2

function Invoke-WriteNonTerminatingErrorNewExample {
    [CmdletBinding()]
    param()

    Write-AtlassianNonTerminatingError `
        -Message 'generated-exception' `
        -ExceptionType 'System.InvalidOperationException' `
        -ErrorId 'Demo.WriteNonTerminatingError.New' `
        -Category InvalidOperation `
        -ErrorAction SilentlyContinue
}

Invoke-WriteNonTerminatingErrorNewExample

Writes a non-terminating error with a newly created exception type.

EXAMPLE 3

function Invoke-WriteNonTerminatingErrorRecordExample {
    [CmdletBinding()]
    param()

    $record = [System.Management.Automation.ErrorRecord]::new(
        [System.Exception]::new('rethrow-record'),
        'Demo.WriteNonTerminatingError.Record',
        [System.Management.Automation.ErrorCategory]::InvalidOperation,
        $null
    )

    Write-AtlassianNonTerminatingError -ErrorRecord $record -ErrorAction SilentlyContinue
}

Invoke-WriteNonTerminatingErrorRecordExample

Writes a non-terminating error using an existing error record.

PARAMETERS

-Cmdlet

Cmdlet runtime to use for writing the error. Defaults to the caller’s $PSCmdlet when called from an advanced function.

Type: PSCmdlet
Parameter Sets: (All)
Aliases:

Required: False
Position: 0
Default value: Caller $PSCmdlet
Accept pipeline input: False
Accept wildcard characters: False

-Exception

Exception used to build the error record.

Type: Exception
Parameter Sets: ExistingException, NewException
Aliases:

Required: True (ExistingException), False (NewException)
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ExceptionType

Exception type used when creating a new exception.

Type: String
Parameter Sets: NewException
Aliases:

Required: False
Position: 2
Default value: System.Management.Automation.RuntimeException
Accept pipeline input: False
Accept wildcard characters: False

-Message

Message used when creating a new exception.

Type: String
Parameter Sets: NewException
Aliases:

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

-TargetObject

Target object associated with the error record.

Type: Object
Parameter Sets: ExistingException, NewException
Aliases:

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

-ErrorId

Identifier for the generated error record.

Type: String
Parameter Sets: ExistingException, NewException
Aliases:

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

-Category

Error category for the generated error record.

Type: ErrorCategory
Parameter Sets: ExistingException, NewException
Aliases:

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

-ErrorRecord

Existing error record to write directly.

Type: ErrorRecord
Parameter Sets: Rethrow
Aliases:

Required: True
Position: 1
Default value: None
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 (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.Exception, System.Management.Automation.ErrorRecord

OUTPUTS

None

NOTES

Write-TerminatingError

On this page