Skip to content
This repository has been archived by the owner on Apr 13, 2023. It is now read-only.

Get JournalReadmeEntries

Nick Spreitzer edited this page Feb 17, 2020 · 1 revision
external help file: JournalCli.dll-Help.xml
Module Name: JournalCli
online version:
schema: 2.0.0

Get-JournalReadmeEntries

SYNOPSIS

Lists readme entries which are due to be re-read.

SYNTAX

All (Default)

Get-JournalReadmeEntries [-All] [-Location <String>] [<CommonParameters>]

Range

Get-JournalReadmeEntries [-Period <String>] [-Duration <Int32>] [-Location <String>] [<CommonParameters>]

DESCRIPTION

Retrieves a list of all readme journal entries which are due to be re-read. More precisely, it returns entries that have a readme date on or before today. The list can be limited to entries which became due for re-reading within a certain range of time, such as over the last year or 18 months.

EXAMPLES

Example 1

> Get-JournalReadmeEntries -Period Years -Duration 1 | Format-List

ReadmeDate : Saturday, August 27, 2019
Headers    : {## ReadMe:}
EntryName  : 2019.08.27
Tags       : {work, exercise}

ReadmeDate : Saturday, August 1, 2019
Headers    : {## Car broke down, ## The evening}
EntryName  : 2019.08.23
Tags       : {work, event, predictions}

ReadmeDate : Sunday, January 26, 2019
Headers    : {# Thursday, September 26, 2019}
EntryName  : 2019.09.26
Tags       : {coding, work}

# Notes:
# 1. This example is contrived, so the entry dates and readme dates may appear a bit odd.
# 2. Format-List is not required; It was used only for readability.

Retrieves all readme entries which have elapsed over the past year.

PARAMETERS

-All

Returns all readme entries which have elapsed prior to today. This is the default and does not need to be explicitly provided.

Type: SwitchParameter
Parameter Sets: All
Aliases:

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

-Duration

A number, greater than or equal to 1, which specifies the number of Periods to include in the results lists. This parameter can only be used in conjunction with -Period, documented below.

Type: Int32
Parameter Sets: Range
Aliases:

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

-Location

The root directory for the journal to search for entries. This is only required if no default journal location has been set, or to search a non-default location.

Type: String
Parameter Sets: (All)
Aliases:

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

-Period

Specifies a period of time - Years, Months or Days - used to filter the number of readme entries returned. This parameter can only be used in conjunction with -Duration, documented above.

Type: String
Parameter Sets: Range
Aliases:
Accepted values: Years, Months, Days

Required: False
Position: Named
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.

INPUTS

None

OUTPUTS

JournalCli.Core.ReadmeJournalEntryCollection

NOTES

RELATED LINKS