private/Write-HostDateTimeDarkCyan.ps1

#Requires -PSEdition Core

function Write-HostDateTimeDarkCyan {
    <#
    .SYNOPSIS
        Writes a timestamped informational message in dark cyan
 
    .DESCRIPTION
        Prefixes a message with a sortable local timestamp and the INFO label, then
        writes the formatted text directly to the host using the DarkCyan foreground
        color. Host text is not written to the success stream.
 
    .PARAMETER Message
        Specifies the text to display. This parameter is mandatory and does not accept a
        null or empty value.
 
    .EXAMPLE
        PS> Write-HostDateTimeDarkCyan -Message 'Mounting the boot image'
 
        Writes the timestamped informational message directly to the host in dark cyan.
 
    .INPUTS
        None. This function does not accept pipeline input.
 
    .OUTPUTS
        None.
 
    .NOTES
        Author: David Segura
        Company: Recast Software
        Version: 1.0.0
        Date: 2026-08-28
 
        Requires PowerShell Core.
    #>

    [CmdletBinding()]
    param (
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [string]$Message
    )

    Write-Host -ForegroundColor DarkCyan ("[{0}] [INFO] {1}" -f (Get-Date -Format s), $Message)
}