Repository navigation
keel 1.0.0
First release of keel: PowerShell modules for unattended automation that sends email and calls REST APIs.
keel.Mail 1.0.0
Send-Email sends mail through Microsoft Graph by default, with Send-MailMessage-style parameters.
- Graph authentication: an access token, an existing Microsoft Graph SDK session, or app-only sign-in with a certificate or client secret.
- SMTP: explicit SMTP delivery, or SMTP fallback when Graph refuses a message or can't be reached.
- No duplicate sends: retries and fallback happen only when the failure proves Graph didn't accept the message. When delivery is uncertain,
Send-Emailstops with aGraphDeliveryUnknownerror instead of risking a second copy. The Graph SDK's own retries are turned off for each send for the same reason. - Attachments: one or more files, checked against Graph's 3 MB inline limit before anything is sent.
- Host configuration: defaults for routing, credentials, Cc, and Reply-To come from
KEEL_*environment variables, so many scripts on a host can be reconfigured in one place. Explicit parameters always win. - Supports
-WhatIfand-Confirm.
keel.Http 1.0.0
Vendor-neutral retry helpers for REST calls.
Invoke-WithBoundedRetry: exponential backoff with jitter, a configurable list of retryable status codes, andRetry-Aftersupport.Get-RetryableStatusCode: reads the HTTP status from errors raised byInvoke-RestMethod,Invoke-WebRequest, and the Graph SDK, across PowerShell versions.
Requirements
- Windows PowerShell 5.1 or PowerShell 7+.
- For Graph delivery: the
Mail.Sendapplication permission, plus an access token orMicrosoft.Graph.Authentication.
On Windows PowerShell 5.1, SMTP delivery can't set a Reply-To header, because 5.1's Send-MailMessage has no -ReplyTo parameter. The message is sent without it and a warning is written.
Documentation
- README: installation, usage, environment variables, and testing.
- ADR 0001: why configuration comes from environment variables.
- ADR 0002: why keel never resends after an ambiguous Graph failure.
Tested on Ubuntu, macOS, and Windows with PowerShell 7, and on Windows PowerShell 5.1.