Magic Dash Management via CLI

This one is courtesy of David Kniskern, the one, the only.
Also available in the Community Meta-Repo

Overview

The Hudu Magic Dash Manager is a powerful PowerShell script designed to provide comprehensive management of Magic Dash tiles within your Hudu instance. This tool offers an intuitive, menu-driven interface for creating, updating, deleting, and managing Magic Dash tiles across all companies in your Hudu environment.

Prerequisites

System Requirements

• PowerShell 7.5.1 or higher

• Windows 10/11 (or compatible PowerShell environment)

• Internet connectivity to your Hudu instance

• Azure Key Vault access (for credential management)

Required Access

• Hudu API Key (24-character key from your Hudu instance)

• Hudu Instance URL (your Hudu domain without trailing slash)

• Azure Key Vault with stored credentials

• Magic Dash functionality enabled in your Hudu instance

Installation & Setup

Step 1: Download the Script

A. clone the community repo

git clone https://github.com/Hudu-Technologies-Inc/Community-Scripts

B. download just this script from Github

$(Invoke-WebRequest -uri "https://raw.githubusercontent.com/Hudu-Technologies-Inc/Community-Scripts/refs/heads/main/Information-and-Visualization/Managing-MagicDashes/Managing-MagicDashes.ps1").content | Out-File .\Managing-MagicDashes.ps1

Step 2: Azure Key Vault Setup

If you haven't set up keyvault or fetching your secret fails, you will be asked to type in your Hudu API key, which is removed from memory when script completes

1. Create Azure Key Vault (if not already created):

2. Add Hudu API key as a new secret in this vault

3. Change the $VaultName variable in this script to the name of your vault

4. Change the $ApiKeySecretName variable in this script to the name of your secret which has your Hudu API key

Step 3: Verify Installation

Invoke the script-

(if you cloned Community repo)

. .\Information-and-Visualization\Managing-MagicDashes\Managing-MagicDashes.ps1

(if you downloaded directly)

. .\Managing-MagicDashes.ps1

Configuration

Azure Key Vault Configuration

The script expects the following secrets in your Azure Key Vault:

Usage Guide

Starting the Script

1. Open PowerShell as Administrator

2. Navigate to the script directory

3. Run the script:

   Copy

   .\interactive_magic_dash_manager.ps1

Main Menu Navigation

Upon startup, you'll see the main menu:

🎯 WELCOME TO THE MAGIC DASH MANAGER🎯.               

  ┌─ 1. Select a company with existing Magic Dash tiles
  ├─ 2. Create a new Magic Dash tile for any company
  └─ 0. Exit

Option 1: Managing Existing Tiles

1. Select a company from the list of companies with Magic Dash tiles

2. Choose management option:

   • Mass Delete - Delete all tiles for the company

   • Individual Delete - Select specific tiles to delete

   • Update Tiles - Modify existing tile properties

   • Create New - Add a new tile to the company

Option 2: Creating New Tiles

1. Enter company name (case-sensitive)

2. Provide tile details:

   • Title - Name of the Magic Dash tile

   • URL - Link destination (must include https://)

   • Description - Optional description text

Navigation Tips

• Type '0' at any input prompt to return to the previous menu

• Type 'No' at any Yes/No prompt to go back to the previous page

• Press Enter to keep current values when updating tiles

• Use '0' to exit any menu and return to the main menu