New‑ObjectNotFoundException - dsccommunity/DscResource.Common GitHub Wiki

Creates and throws an object not found exception.

New-ObjectNotFoundException [-Message] <String> [[-ErrorRecord] <ErrorRecord>]
 [<CommonParameters>]

Creates and throws an object not found exception.

try
{
    Get-ChildItem -Path $path
}
catch
{
    New-ObjectNotFoundException -Message 'Could not get files' -ErrorRecord $_
}

Creates and throws an object not found exception with the message 'Could not get files' and includes the exception that caused this terminating error.

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

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

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