Skip to content

Home

Jump to bottom
Michael19842 edited this page Nov 9, 2025 · 5 revisions

logo MvRAdaptiveCards PowerShell Module

Welcome to the MvRAdaptiveCards PowerShell Module Wiki! This comprehensive guide will help you master creating, posting, and working with Adaptive Cards in PowerShell.

Work in progress: This wiki is actively being developed. Some sections may be incomplete or under construction. Check back soon for updates!

📚 Quick Links

🚀 What is MvRAdaptiveCards?

MvRAdaptiveCards is a feature rich PowerShell module that provides a framework of easy-to-use functions for working with Adaptive Cards. If you're familiar with PSWriteHTML, you'll find the approach in MvRAdaptiveCards quite similar - it uses a declarative, scriptblock-based syntax that makes creating complex cards intuitive and maintainable.

Key Features

  • ✅ Declarative Syntax - Build cards using PowerShell scriptblocks, similar to PSWriteHTML
  • ✅ Rich Elements - Support for text, images, inputs, charts, icons, badges, and more
  • ✅ PowerShell integration - Leverage PowerShell's capabilities to create dynamic and data-driven cards usable to prompt the local user
  • ✅ Multiple Display Methods - EdgeApp windows, Teams integration, Browser, Online designer
  • ✅ Template System - Dynamic content with template tags like {{variable}}
  • ✅ Construct support - Pre-defined card constructs for common patterns like wizards and notificationss
  • ✅ Chart Integration - Donut, gauge, horizontal bar charts (with Chart.js for local rendering)
  • ✅ Fluent UI Icons - Built-in support for Microsoft Fluent UI icons for local rendering
  • ✅ Custom Extensions - JavaScript/CSS extension system allowing for local sollutions to render the latest Adaptive Card features

📦 Installation

Install the module from the PowerShell Gallery using the following command:

Install-Module -Name MvRAdaptiveCards

Note: This module is compatible with PowerShell 5.1, however, for the best experience, using it with PowerShell 7.x or later is recommended.

Compatible with PowerShell 5.1 and later versions.

🎯 Quick Start Example

New-AdaptiveCard {
    New-CardTextBlock -Text "Hello, Adaptive Cards!" -Size Large -Weight Bolder
    New-CardTextBlock -Text "Built with PowerShell" -Wrap
    New-CardImage -Url "https://adaptivecards.io/content/cats/1.png" -Size Medium
    New-CardActionSet -Actions {
        New-CardActionOpenUrl -Title "Learn More" -Url "https://adaptivecards.io"
    }
} | Get-CardResponse

📖 Documentation Sections

Getting Started

Core Concepts

  • Card structure
  • Elements vs Containers vs Actions
  • Scriptblock pattern
  • Template system
  • Styling and themes

Function Categories

  • Card Creation: New-AdaptiveCard
  • Elements: Text, Images, Icons, Charts, Progress bars
  • Containers: Columns, Container, FactSet, Table
  • Inputs: Text, Date, Time, Number, Toggle, ChoiceSet
  • Actions: Submit, OpenUrl, ToggleVisibility, ShowCard
  • Charts: Donut, Gauge, HorizontalBar
  • Templates: Template tags, dynamic content

Examples Gallery

  • Simple notifications
  • Interactive forms
  • Multi-page wizards
  • Data dashboards
  • Status reports
  • Team notifications

Advanced Topics

  • Custom extensions (JavaScript/CSS)
  • Hidden element management
  • Toggle visibility patterns
  • Chart customization
  • Icon rendering
  • Performance optimization

🆘 Support

For help and support, check out the following resources:

📝 Contributing

Contributions are welcome! Please check the main repository for contribution guidelines.

Last updated: November 2025

Clone this wiki locally