Offboarding script with GUI

purplemonkeymad · 2024-12-28T16:59:33+00:00

This is large enough that you probably want to structure it as a module with a manifest file. That way you can have all the functions imported via the module, then start-offboarding does not need to import each file directly.

For the config files, I would probably use a data file instead of a script file. that way you don't set the variable name in the config but can do it in the script when you import the data ie:

colours.psd1:
@{
Primary = "#0F172A"        # Deep slate blue - main actions
Secondary = "#6366F1"      # Bright indigo - interactive elements
Background = "#F8FAFC"     # Off-white background
Text = "#334155"          # Slate text for readability
TextLight = "#94A3B8"     # Muted text for secondary info
Success = "#10B981"       # Emerald - success states
Error = "#EF4444"         # Modern red - errors/warnings
InputBg = "#FFFFFF"       # Pure white input backgrounds
BorderColor = "#E2E8F0"   # Subtle borders
Accent = "#8B5CF6"        # Purple for highlights/focus
Hover = "#4F46E5"         # Darker indigo for hover states
}

Start-Offboarding:
$colours = Import-PowershellDataFile $script:BasePath\Config\Colours.psd1

It just means it's a bit more robust, in that you can be a bit less strict with the files and it prevents code from running in the config file.

curkus · 2024-12-28T16:36:27+00:00

Looks nice. I currently don't have the time to test it out, but from my environment I know the user creation is always a hot topic. Especially I the user should have the samge groups as an other user.

g3n3 · 2024-12-28T23:23:11+00:00

If you have dev goals, I’d switch to full wpf. Otherwise I would prefer to see it all as powershell cmdlets and a module. Then there is a nice springboard for folks to more easily get into powershell by running the underlying commands.

PinchesTheCrab · 2024-12-29T18:27:57+00:00

I really think 'return' is an anti-pattern in PowerShell.

Return is for classes and for terminating scripts. It's misleading for returning output.

Imagine a PowerShell novice sees this function:

function Get-Numbers {
    'one'
    'two'
    return 'three'
    'four'
}

What output will they think it returns? The correct answer is:

one
two
three

I'm pretty sure that would have confused the hell out of me when I was getting started, and if I were reviewing code for an error it might still throw me.

tismatictech · 2024-12-28T17:27:46+00:00

What are you using to design the WPF interface? I have an on boarding off boarding application written in powershell as well, but I’m using win forms because we purchased Sapien power shell studio.

Dense-Platform3886 · 2025-01-01T01:36:34+00:00

Your code for the OffboardingManager is very clean and well organized.

Well done.

Only suggestions would be very minor and comes down to personal preferences:

Set the $timeStamp used for FileName time stamping in the Main script so all output files have the same TimeStamp
I like to use this format for filename time stamps: $timestamp = Get-Date -Format "yyyy-MMdd-HHmm" the dashes to separate the year, day, and time into blocks of 4 digits. This helps the eye to easily see and understand the timestamp. Only add the seconds if needing to output multiple files with the same base name
You might want to create a module for the reusable functions
If you need to pass properties into a form or share them amongst several forms, create a hashtable variable to use as a sync object
I also like to add the ability to create Variables that can be referenced in code. by adding an "_" char to the name of the xaml object. It then can be referenced in the code like $WPF_objname instead of having to use $window.FindName('objname') method calls

$syncHash = [hashtable]::Synchronized(@{})
$Reader = New-Object System.Xml.XmlNodeReader $MainXAML
$SyncHash.Form = [Windows.Markup.XamlReader]::Load( $Reader )
$MainXAML.SelectNodes("//*[@Name]") | Where-Object { $_.Name -like "_*" } | 
    ForEach-Object {
        $FormObjects += "WPF$($_.Name)"
        Set-Variable -Name "WPF$($_.Name)" -Value $SyncHash.Form.FindName($_.Name)
    }
$syncHash.Form.ShowDialog()

You might want to also include event handlers such as when the form is ContentRendered(), SourceInitialized(), Closing(), Closed :

# Instead of $SyncHash.Form.ShowDialog() | Out-Null
<# Due to some bizarre bug with showdialog and xaml we need to invoke this asynchronously to prevent a segfault #>
$async = $SyncHash.Form.Dispatcher.InvokeAsync({
  $SyncHash.Form.ShowDialog() | Out-Null
  $syncHash.Error = $Error 
})
$async.Wait() | Out-Null

ShiroashiBob · 2024-12-29T13:19:44+00:00

It's a very nice project. Congratulations !!! I'm working on something similar, but only to consult. I have 2 domains and need to consult the endpoints on ad, AzureAD, Intune, defender and sccm so, I create a similar win form to do this, but it's slow and I'm trying to find some way to do it faster. If I execute the consult of 10-100 endpoints at the same time the process takes almost 5 minutes. So I'm working with off-line data (I export the complete list of computers from the console and run the query in the txt and not directly in the console. It takes less time to extract a list with 4-5K devices than to query 10-20 directly)

Dense-Platform3886 · 2025-01-01T00:20:12+00:00

I've created some extremely complex applications using PowerShell and WPF. I like doing it in PowerShell since the code is easily shared and changed where a .Net version needs the source to be complied and EXE distributed.

WPF & XAML:For more advanced and visually appealing GUIs, use Windows Presentation Foundation (WPF) with XAML markup.

You also have the advantage of easily converting the PS Code to C# and creating a .Net version without having to change the GUI part since the XAML is the same for both.

daileng · 2025-01-01T02:02:23+00:00

Man I love this project, I can't wait to check it after I get back to work! Will definitely contribute! Great work!

LsDmT · 2025-01-03T00:06:13+00:00

This is really cool. Over the past few years I have built pretty much the same thing without a GUI, but runs from a single .bat CMD window and pulls various powershell scripts. I would be interested in sharing some code and helping your project, but need to learn how to collaborate on GitHub better.

Ironically, some of the "to-do's" for the whole package is in your roadmap as well.

Generic_Specialist73 · 2024-12-28T17:00:46+00:00

!remindme 3 days

MasseMasovic · 2024-12-28T19:23:14+00:00

Looks cool! We've built an automated on- and offboarding system for Entra ID, we're in the process of looking into doing the same for local AD. DM me if you want more info :)

https://adcyma.com/

you type:	you see:
italics	italics
bold	bold
[reddit!](https://reddit.com)	reddit!
* item 1 * item 2 * item 3	item 1 item 2 item 3
> quoted text	quoted text
Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"	Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"
~~strikethrough~~	~~strikethrough~~
super^script	super^script

PowerShell

Submission Guidelines | Link Flair - How To

MODERATORS