Cmdlet

New-ConsoleCalendar

Module: ConsoleMonster
Inputs: System.Management.Automation.PSObject[]
Outputs: ConsoleMonster.Widgets.Calendar

Creates a month or year calendar with dated operational outcomes.

Syntax

New-ConsoleCalendar
[-Culture <CultureInfo>]
[-DateProperty <String>]
[-FirstDayOfWeek <DayOfWeek>]
[-InputObject <PSObject[]>]
[-LabelProperty <String>]
[-Month <Int32>]
[-NoLegend]
[-StatusProperty <String>]
[-Today <DateTime>]
[-View <Month|Year>]
-Year <Int32>
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

Returns a passive widget. Pipeline rows provide Date, Status and Label properties, with explicit property overrides. Duplicate dates retain every row; the displayed status uses Fail, Warn, Running, Pending, Pass, Info, Skip precedence. Dates retain calendar components without time-zone conversion. ISO week labels describe the Monday in each row, including with a Sunday-first display.

Examples

Example 1

$calendar = $backups | New-ConsoleCalendar -Year 2026 -Month 10; $calendar | Show-Console

Display backup outcomes for October.

Example 2

New-ConsoleCalendar -Year 2026 -View Year -FirstDayOfWeek Monday

Build a year view with Monday-first weeks.

Parameters

-Culture CultureInfo optional: Culture for month and weekday labels and the default week start.
-DateProperty String optional: Date member (default Date). Convert timestamps to your business time zone before binding.
-FirstDayOfWeek DayOfWeek optional: Override the culture's first weekday.; Possible values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
-InputObject PSObject[] optionalpipeline: True (ByValue): Rows to mark, retaining their original values for day details.
-LabelProperty String optional: Description member (default Label).
-Month Int32 optional: Gregorian month, required in Month view.
-NoLegend SwitchParameter optional: Omit the status symbol legend.
-StatusProperty String optional: Semantic outcome member (default Status).
-Today DateTime optional: Civil date to emphasize as today, useful with a fixed report clock.
-View CalendarView optional: Month (default) or Year.; Possible values: Month, Year
-Year Int32 required: Gregorian year to display.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.