r/PowerShell • u/MadBoyEvo • Jan 06 '20
PowerShell Modules I worked on in 2019
Hello Everyone,
In the last 2 years, I've written over 40 PowerShell modules releasing them all for free on GitHub and providing an overview on my blog. The blog is free, it has no ads, it doesn't cost anything except my time to prepare it and money to host it.
Summary blog posts with description/screenshots and links to sources: https://evotec.xyz/powershell-modules-ive-worked-on-in-2019
Here's a list of +-40 PowerShell Modules I've created over the last 2 years. There are modules that provide a full spectrum of options for anyone interested:
Active Directory Functions
Word creating/reading
PDF creating/split/merge
HTML creating without zero HTML/CSS/js knowledge
HTML parsing
RSS
SIEM, Event Logs
Microsoft Teams
Discord
Lansweeper
And many others.
As PowerShell is no longer Windows only some of those modules work just fine on Linux and macOS. Usually, PowerShell 5.1, PowerShell 6 and PowerShell 7 are supported if the underlying .NET provides that option.
All those modules are free, fully open source.
In 2018 I've written 21 of them
In 2019 another 20
In 2020 I plan to reduce the number of modules integrating some of the stuff together, however, it's possible new ones will be born.
As I don't have too much place here to provide a full overview of it here I do encourage you to visit blog post I wrote that covers in the summary which module does what and how you can use it. I've logged 1,427 hours on, on average, of 3 hrs 59 mins per day. my best day was Feb 17, 2019, with 10 hrs 22 mins.
I've mostly used the VS Code on Windows and of course, my top language was PowerShell (which should be obvious but I've used lots of XML/HTML/JS/CSS as well. With over 300 hours going into PSWriteHTML and over 150 in Testimo I have to say it was a busy year.
As always I'm here if you have any questions. I hope you had a good 2019, just like I did.
With regards,
MadBoyEvo
5
u/froztymug Jan 07 '20
I've spent less then 5 minutes replying to anything on reddit. I'm glad there are people like you to counter balance people like me. Truely am grateful for what you've shared.
5
u/MadBoyEvo Jan 07 '20
Reddit has both good and bad sides. People downvote for no reason or you get banned for "advertising". I prefer to look on the bright sides but it's a bit disappointing to see posts downvoted (not only mine but overall). I prefer to either vote up or not vote at all. I know how hard it is to start blogging and continue writing, how hard it is to write scripts or modules and downvoting doesn't help - like at all.
3
u/ipreferanothername Jan 07 '20
awesome! how much of this do you develop at work vs on the side?
3
u/MadBoyEvo Jan 07 '20
Most go on the side. Only some of that stuff is needed for work. I usually have this ready and then work uses it. Not the other way around. It all started with PSEventViewer/PSWinReporting as a work project to fulfill the goal of monitoring events. But other stuff was just me needing to simplify my job - but not really necessary. PSWritePDF, PSWriteWord - none of that was ever requested.
3
u/ipreferanothername Jan 07 '20
oh yeah i get something not being requested, i just end up working on something and going...well, this is silly to do manually, so i write my own tools to do the job. then if i use them a lot i tidy them up and try to pass them on to my team. the stuff that was requested of me is usually fairly simple, monitor and move some files, do something really basic in AD. people don't always think as big about automating i guess as the people who can do the automating and really understand the capabilities.
2
2
u/vholmes1422 Jan 07 '20
Great job, and thank you for sharing. It helps to see how other people approach a solution. I just started doing more with PowerShell and working on creating a module for work. I have one question related to the public/private folders on GitHub. Is there a reason why you separate them?
4
u/MadBoyEvo Jan 07 '20
Yes. I've started my first ever module by reading an article by psCookieMonster http://ramblingcookiemonster.github.io/Building-A-PowerShell-Module/
I've been using this approach ever since but with few changes.
I create public/private/lib/resources and other folders as needed - it's easier to manage 50 lines of code, easier to search, easier to collaborate on Github
I've written PowerShell module PSPublishModule which merges all files from public/private into single psm1 file (why? https://evotec.xyz/powershell-single-psm1-file-versus-multi-file-modules/)
The same module takes anything in the Public folder and exports all function names and aliases and puts them into .psm1 to Export command and also into PSD1 command. This is best-performance wise as per PowerShell Best Practice. This also prevents users from using Private, non-exposed functions. It means I can have 50 functions in a module and only 1 being public.
The same module is also merging some dependencies into single psm1 file
This allows me to have a single PSM1 that is optimized/formated with only aliases/function names exported from the public folder.
The PSPublishModule does some weird tricks that are a bit special for my needs so not sure if it would be useful for anyone else but what it does it:
You make your development in a folder like C:\Github<YourProject>
When you run the tool it links files it needs from folders Private/Public/Resources into TEMP directory and then proceeds with merging and creating everything. This means only "critical" stuff is copied into the final module folder. This means you can have other folders in the project folders such as Examples/Docs/Ignore or any other folder and all that is skipped except some native stuff.
Finally, it copies it to PowerShell module folders for "optimal use".
It can also publish modules directly and it uses that "optimized" version without all that junk you have in development.
It updates PSD1 for you. It controls version for you (you just manage single ps1 hash - here's an example for Testimo - https://github.com/EvotecIT/Testimo/blob/master/Publish/Manage-Testimo.ps1
I just run this .ps1 every time I want to build it for release and it does its magic.
But like I said, it's a bit hacky hack as I add features that I need. Never described how it actually works and not sure it will work for anyone else without some hardening.
The cool feature that I added lately is that you can provide some "approved" modules such as PSSharedGoods/PSWriteColor into it and if your module uses them it can copy needed functions from those modules and integrate it into your final publish. It can also show you during the build if any of the commands are potentially used, but not mentioned in the required modules.
Probably sometime in 2020 I'll update it, make it more error-proof and release.
You can see what it does to where here (it's described a bit here - https://evotec.xyz/emailimo-merged-into-pswritehtml-ie-support-and-no-dependencies/ ) - I tried attaching img here but it was hanging Reddit.
26
8
u/ID10T-3RR0R Jan 06 '20
Love yah brotha, use your hard-work all the time. You've saved me countless hours digging, my family appreciates it the most!
5
3
3
3
3
Jan 07 '20
Very interesting. Im from a start of just writing code in Tasker,(lol) than alot of python and recently nodejs. Been avoiding PowerShell because I love my bigass doskey macro list. It's not a good excuse. Lol. this blog looks great I'll go through it. Cheers
3
3
u/TomekkPL1 Jan 07 '20
PSWriteHTML has been a huge help for us in formatting reports. I really appreciate your work here. Dziękuję!
2
2
0
Jan 06 '20
[deleted]
10
u/MadBoyEvo Jan 06 '20
Glad people like it. It’s also my way of documenting things. Otherwise there would be just examples which are sometimes hard to understand.
2
Jan 07 '20
Finding People doing this kinda approach is probably the best way learnto code. I think it ages a laungage in a really good way too. You can look up more than just that 1 link to stack that kiinndddaaa answers someone else's question. I have stock piles mountains high of awesome code that's to hard to cut out I'll probably never use. Lol
6
u/subnascent Jan 07 '20
I regularly use and adapt your modules and your coding style in my personal projects. What goes around comes around MadBoyEvo, you are releasing PowerShell love out into the world.
A thousand blessings!