Skip to content

Latest commit

 

History

History
53 lines (39 loc) · 1.96 KB

README.md

File metadata and controls

53 lines (39 loc) · 1.96 KB
Raw

RDCMan

Tools for streamlining Remote Desktop Configuration Manager tasks, including:

  • Import RDCMan configuration (servers, groups, and settings) from JSON, CSV, XML, PSD1, and Active Directory.
  • Import RDCMan credentials from credential objects, secure strings, Microsoft.PowerShell.SecretStore, and KeePass.
  • Export RDCMan configuration to JSON, CSV, XML, PSD1.
  • Generate new RDCMan configuration.
  • Validate RDCMan configuration format.
  • Compare RDCMan groups to Active Directory OUs, containers, and groups.
  • Update RDCMan configuration from JSON, CSV, XML, PSD1, and Active Directory.
  • Backup RDCMan configuration.
  • Set RDCMan policies
  • Encrypt RDCMan credentials using CryptProtectData or an x509 certificate.
  • Start RDCMan with a specific configuration and/or immediately connect to a list of servers.

Install

Install from GitHub source:

git clone 'https://github.com/devynspencer/powershell-rdcman'
cd .\powershell-rdcman

Environment

This module looks for the following environment variables:

RDCMAN_BACKUP_PATH=C:\path\to\rdcman-backup.rdg
RDCMAN_BACKUP_COUNT=5
RDCMAN_CONFIG_PATH=C:\path\to\rdcman.rdg
RDCMAN_PATH=C:\path\to\RDCMan.exe
RDCMAN_EXPORT_FORMAT=JSON

Alternatively, these can be added to a local secret store using Microsoft.PowerShell.SecretStore:

Set-Secret -Name 'RDCMAN_BACKUP_PATH' -Secret 'C:\path\to\rdcman-backup.rdg'
Set-Secret -Name 'RDCMAN_BACKUP_COUNT' -Secret 5

# ...

Examples

Get an RDCMan configuration as a PowerShell object:

Get-RDCManConfiguration -Path 'C:\path\to\rdcman.rdg'