initial commit

Author: techthoughts2

.github/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 03 Sep 2019
+
+- Initial release.

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,75 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at [email protected]. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [https://www.contributor-covenant.org/version/1/4/code-of-conduct.html](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html)
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq)

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "powershell.codeFormatting.preset":"Stroustrup"
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Jake Morrison
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LearnPowerShell/EP1 - PowerShell Basics.ps1

@@ -0,0 +1,41 @@
+#____________________________________________________________
+# https://techthoughts.info/learn-and-use-powershell-with-just-three-commands/
+#____________________________________________________________
+# your first cmdlet - getting timezone information
+
+Get-TimeZone
+#____________________________________________________________
+# Get-Command
+
+Get-Command *
+# An asterisk (*) in many languages acts as a wildcard. This syntax is saying: get me ALL of the commands
+
+Get-Command *process*
+# the wild cards around process will find ANY command that contains the word process
+
+# Get-Command can't always find everything, you may have to Google
+Get-Command *file*
+#____________________________________________________________
+# Get-Help
+
+# Windows Users:
+Get-Help Stop-Process
+#Linux/MacOs Users
+Get-Help Stop-Process -Online
+
+Get-Help Stop-Process -Examples
+#____________________________________________________________
+# Get-Member
+
+Get-Date | Get-Member
+
+Get-Random | Get-Member
+#____________________________________________________________
+# Expand the available viewable properties of a cmdlet with Format-List
+
+Get-Date | Format-List
+#____________________________________________________________
+# Find-Module
+
+Find-Module -Tag Telegram
+#____________________________________________________________

LearnPowerShell/EP2 - PowerShell Pipeline.ps1

@@ -0,0 +1,81 @@
+#____________________________________________________________
+# https://techthoughts.info/working-with-the-powershell-pipeline/
+#____________________________________________________________
+# the pipeline operator
+
+Get-Process | Sort-Object Id
+#____________________________________________________________
+# In this example, every command found will be "piped" to Get-Help
+# This will run Get-Help against EVERY command found
+
+Get-Command | Get-Help
+#____________________________________________________________
+# This example would restart the BITS service!
+
+Get-Service -Name BITS | Restart-Service
+#____________________________________________________________
+# try running this command on your machine to see the results.
+# the WhatIf parameter will make Stop-Process take no actual action
+
+Get-Process | Stop-Process -WhatIf
+#____________________________________________________________
+# PSItem
+# Get all processes. For each process (object) found,
+# display that object
+
+Get-Process | ForEach-Object {$PSItem}
+
+# In this simple example, we will display the current object
+# to the console
+1,2,3 | ForEach-Object {$PSItem}
+
+# Spelling out $PSItem (not common)
+1,2,3 | ForEach-Object {$PSItem}
+# using $PSItem shorthand (common)
+1,2,3 | ForEach-Object {$_}
+#____________________________________________________________
+# Format-List & Format-Table
+
+# Note the way things look using Format-Table
+Get-Process | Format-Table
+# Now see how that differs if you pipe instead to Format-List
+Get-Process | Format-List
+
+# Note the return from just Get-Date
+Get-Date
+# Now see how the whole object is returned if you pipe to Format-List
+Get-Date | Format-List
+
+# basic information about the notepad process
+Get-Process notepad
+# more information about the notepad process
+Get-Process notepad | Format-List
+# all available information about the notepad process
+Get-Process notepad | Format-List
+#____________________________________________________________
+# Select-Object
+
+# Using Select-Object you can retrieve only the properties you are after
+Get-Process | Select-Object Name,Id,CPU,Responding
+#____________________________________________________________
+# Sort-Object
+
+# This example pipes all processes to Sort-Object which sorts by CPU use
+# Use to quickly identify your busiest processes. Very handy!
+Get-Process | Sort-Object CPU
+
+# You can combine multiple pipelines together as well
+Get-Process | Select-Object Name,Id,CPU,Responding | Sort-Object CPU
+#____________________________________________________________
+# Where-Object
+
+# Get Processes, return only those where current object $_ is greater than 15
+Get-Process | Where-Object {$_.CPU -gt 15}
+
+# Get file information for all files found in the $HOME directory
+# Return information for only files that are greater than 5MB in size
+Get-ChildItem $HOME -Recurse | Where-Object {$_.Length -gt 5MB}
+
+# Count the number of large file in your $HOME directory
+Get-ChildItem $HOME -Recurse | Where-Object {$_.Length -gt 50MB} | Measure-Object
+#____________________________________________________________

LearnPowerShell/EP3 - State of the Shell.ps1

@@ -0,0 +1,16 @@
+#____________________________________________________________
+# https://techthoughts.info/powershell-history-and-current-state/
+#____________________________________________________________
+# determine what version of PowerShell you are running with the following:
+$PSVersionTable
+# The PSVersion number is the version. you can get it specifically like this:
+$PSVersionTable.PSVersion
+#____________________________________________________________
+# in a 5.1 window count the number of cmdlets:
+Get-Command | Measure-Object
+# now try the same thing in a 6+ console window
+Get-Command | Measure-Object
+#____________________________________________________________
+# in a 6+ console window run the following:
+Install-Module WindowsCompatibility -Scope CurrentUser
+#____________________________________________________________

LearnPowerShell/EP4 - PowerhShell Development.ps1

@@ -0,0 +1,35 @@
+#____________________________________________________________
+# https://techthoughts.info/getting-setup-powershell-development/
+#____________________________________________________________
+code --list-extensions
+code --install-extension ms-vscode.PowerShell
+
+# PowerShell base VSCode settings:
+<#
+{
+    // editor
+    "editor.quickSuggestionsDelay": 1,
+    "editor.tabCompletion": "on",
+    "files.defaultLanguage": "powershell",
+
+    // default shell
+    // Windows
+        // PowerShell 6
+            "terminal.integrated.shell.windows": "C:\\Program Files\\PowerShell\\6\\pwsh.exe",
+            "powershell.powerShellExePath": "C:\\Program Files\\PowerShell\\6\\pwsh.exe",
+        //PowerShell 5.1 and below
+            // "terminal.integrated.shell.windows": "C:\\WINDOWS\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+            // "powershell.powerShellExePath": "C:\\WINDOWS\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+    // Linux
+        // Ubuntu
+            // "terminal.integrated.shell.linux": "/snap/powershell/36/opt/powershell/pwsh",
+            // "powershell.powerShellExePath": "/snap/powershell/36/opt/powershell/pwsh",
+
+    // powershell settings changes
+    "powershell.codeFormatting.preset":"Stroustrup",
+    "powershell.startAutomatically": true,
+    "powershell.scriptAnalysis.enable": true,
+    "powershell.integratedConsole.showOnStartup": false,
+    "powershell.integratedConsole.focusConsoleOnExecute": true,
+}
+#>

LearnPowerShell/EP5 - PowerShell Variables.ps1

@@ -0,0 +1,83 @@
+#____________________________________________________________
+# https://techthoughts.info/working-with-powershell-variables/
+#____________________________________________________________
+#https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_variables?view=powershell-6
+#https://docs.microsoft.com/en-us/powershell/scripting/learn/using-variables-to-store-objects?view=powershell-6
+#____________________________________________________________
+Get-Process
+$processes = Get-Process
+$processes
+#----------------------------------------
+# not using variable
+Get-Process | Where-Object {$_.CPU -gt 5000} #find processes keeping the CPU busy
+Get-Process | Sort-Object WorkingSet64 -Descending #sort processes by memory usage
+#----------------------------------------
+# using variable
+$processes = Get-Process
+$processes | Where-Object {$_.CPU -gt 5000} #find processes keeping the CPU busy
+$processes | Sort-Object WorkingSet64 -Descending #sort processes by memory usage
+#----------------------------------------
+# not strong typed
+$myNewVariable
+
+# data types
+#----------------------------------------
+$total = 2 + 2
+$total
+$total | Get-Member
+#----------------------------------------
+$total = '2 + 2'
+$total
+$total | Get-Member
+#____________________________________________________________
+# understanding data types
+
+$num1 = 2
+$num2 = 2
+$total = $num1 + $num2
+$total
+#----------------------------------------
+$num1 = '2'
+$num2 = '2'
+$total = $num1 + $num2
+$total
+#----------------------------------------
+
+#strong type
+#----------------------------------------
+[int]$num1 = '2'
+[int]$num2 = '2'
+$total = $num1 + $num2
+#----------------------------------------
+
+#convert
+#----------------------------------------
+$stringReturn = $total.ToString()
+$total | Get-Member
+#----------------------------------------
+
+#quotes
+$literal = 'Two plus one equals: $(1 + 2)'
+$literal
+$escaped = "Two plus one equals: $(1 + 2)"
+$escaped
+Write-Host '$escaped'
+Write-Host "$escaped"
+
+#constant variables are reserved
+Get-Variable
+# you can't use these
+$HOME = 'c:\test'
+
+#environment variables
+Get-ChildItem env:
+$env:COMPUTERNAME
+$env:USERNAME
+
+#putting it all together with an example
+$path = Read-Host -Prompt 'Please enter the file path you wish to scan for large files...'
+$rawFileData = Get-ChildItem -Path $path -Recurse
+$largeFiles = $rawFileData | Where-Object {$_.Length -gt 100MB}
+$largeFilesCount = $largeFiles | Measure-Object | Select-Object -ExpandProperty Count
+Write-Host "You have $largeFilesCount large file(s) in $path"
+#____________________________________________________________