HelpDesk

1.0.0

Functions/Public/Unlock-LockedOutADUsers.ps1

                                <#

.SYNOPSIS

    This function performs an unlock of users in ActiveDirectory who are currently locked out.

.DESCRIPTION

    This function is a simple wrapper for Unlock-ADAccount.

.OUTPUTS

    None

        This function does not produce output except for write-output data

.EXAMPLE

    PS>Unlock-LockedOutADUsers -SAMAccountName matthewjd

    Unlocking: matthewjd

    Description

    -----------

    This will unlock the AD Account for user 'matthewjd'.

.EXAMPLE

    PS>Get-LockedOutADUsers | Unlock-LockedOutADUsers

    Unlocking: User1

    Unlocking: User2

    Description

    -----------

    This gets a list of all current locked out users from Get-LockedOutADUsers and forwards each user to Unlock-LockedOutADUsers, which effectively unlocked all currently locked AD Users

    A short-handed command for this using aliases: PS> glo | ul

.NOTES

    Author: Matthew J. DeGarmo

    GitHub: https://github.com/matthewjdegarmo

#>

function Unlock-LockedOutADUsers() {

    [CmdletBinding()]

    param (

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [Alias('Username')]

        [string[]]$SAMAccountName

    )

    begin {}

    process {

        try {

            foreach ($Username in $SAMAccountName) {

                Write-Output "Unlocking: $Username"

                Unlock-ADAccount -Identity $Username -ErrorAction Stop

            }

        }

        catch {

            Write-Error "$($_.Exception.Message)"

        }

    }

}

# SIG # Begin signature block

# MIIPcgYJKoZIhvcNAQcCoIIPYzCCD18CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQULk94naW5kYQyYeS6Zid/FJxD

# Ke2gggzlMIIGXzCCBUegAwIBAgIKFf/aSAACAACzwTANBgkqhkiG9w0BAQsFADBI

# MRMwEQYKCZImiZPyLGQBGRYDY29tMRcwFQYKCZImiZPyLGQBGRYHbnBwZG5ldDEY

# MBYGA1UEAxMPTlBQRElzc3VpbmdDQTA0MB4XDTE4MTAwNjAxMTkwMVoXDTIwMTAw

# NTAxMTkwMVowJTEjMCEGA1UEAwwaRGVHYXJtbywgTWF0dGhldyBKLiBbRGFzaF0w

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDIUpGz5BW0vsL9Y6oO3lKl

# eM7a6z51Ndn/HMljhxNvrMPH/w9olw6pMn8wnBSxoBzu0X0eO1t6ysl8M5ZeXOnh

# t6Kx7R0EhVL4qyggnxUjEVP8ltY9D5vSgGfI9uulZSejHxcfeNOEfLap2v4ou6lH

# g1OR9wdjCgCWUKUk4Gij+/GJQmudKtDyOEUIvFZbJw9f3mGUSZKjWXTB8I9FYF/I

# NGD9tsnxkQs7e/aZmA7W4K4ul6wGsjGhqG7P5acqKcM47murc2g0kdvoqcVEry/2

# K4TPvpxs71Z8HsiHVIJxcsnfUMW0x7hr0iEmsTW028T3aE0R1otfdV2Xt4AgRNDF

# AgMBAAGjggNsMIIDaDA9BgkrBgEEAYI3FQcEMDAuBiYrBgEEAYI3FQiFlIobhO3q

# F4T9iy6E3NB3hoKqPYFChKb1RNyscAIBZAIBAjATBgNVHSUEDDAKBggrBgEFBQcD

# AzALBgNVHQ8EBAMCB4AwGwYJKwYBBAGCNxUKBA4wDDAKBggrBgEFBQcDAzAdBgNV

# HQ4EFgQUz191vSEkuETcmSi2TdUbsLE3MVcwHwYDVR0jBBgwFoAUSFVgCJ/28xHg

# RU3XdEatEBPTNUYwggFKBgNVHR8EggFBMIIBPTCCATmgggE1oIIBMYaBumxkYXA6

# Ly8vQ049TlBQRElzc3VpbmdDQTA0KDIpLENOPVlPQ1NFQzIyLENOPUNEUCxDTj1Q

# dWJsaWMlMjBLZXklMjBTZXJ2aWNlcyxDTj1TZXJ2aWNlcyxDTj1Db25maWd1cmF0

# aW9uLERDPW5wcGRuZXQsREM9Y29tP2NlcnRpZmljYXRlUmV2b2NhdGlvbkxpc3Q/

# YmFzZT9vYmplY3RDbGFzcz1jUkxEaXN0cmlidXRpb25Qb2ludIY9aHR0cDovL1lP

# Q1NFQzIyLm5wcGRuZXQuY29tL0NlcnRFbnJvbGwvTlBQRElzc3VpbmdDQTA0KDIp

# LmNybIYzaHR0cDovL3d3dy5ucHBkLmNvbS9jZXJ0ZGF0YS9OUFBESXNzdWluZ0NB

# MDQoMikuY3JsMIIBIwYIKwYBBQUHAQEEggEVMIIBETCBrgYIKwYBBQUHMAKGgaFs

# ZGFwOi8vL0NOPU5QUERJc3N1aW5nQ0EwNCxDTj1BSUEsQ049UHVibGljJTIwS2V5

# JTIwU2VydmljZXMsQ049U2VydmljZXMsQ049Q29uZmlndXJhdGlvbixEQz1ucHBk

# bmV0LERDPWNvbT9jQUNlcnRpZmljYXRlP2Jhc2U/b2JqZWN0Q2xhc3M9Y2VydGlm

# aWNhdGlvbkF1dGhvcml0eTBeBggrBgEFBQcwAoZSaHR0cDovL1lPQ1NFQzIyLm5w

# cGRuZXQuY29tL0NlcnRFbnJvbGwvWU9DU0VDMjIubnBwZG5ldC5jb21fTlBQRElz

# c3VpbmdDQTA0KDIpLmNydDAzBgNVHREELDAqoCgGCisGAQQBgjcUAgOgGgwYLW1q

# ZGVnYXJAcHJkLm5wcGRuZXQuY29tMA0GCSqGSIb3DQEBCwUAA4IBAQDOHwyouXYs

# 9QTPaMWrLX5SYsTkngrDHVyQUHyct5TVMahP7Q2pGY1w5CppD3youXBaEBi25EFx

# Oa78Bx8LTLaNr2i6Oku4fhjAtPuosB7TL8ODGCDK1kif20isPr3DIs2ke3rtBg/9

# 7AHm50RQ0hVN7xEKc+WNsOM954oa7D7pMvtwn3L4hxo61Xd6TyzPxD3PcEdN3k1L

# /qX0oIK7I/imAalAGZTtVgsTopVbXUkSGfL09kRjiWSi3NvM3BaYQXCsxKAp2FEL

# 2R1/zTDohqgX4mpoRkz8kn23/MY+y9hpsAyVrIrVqCRq4oxu1wU99jJ7jFlbnOJM

# d+6EJ922c65jMIIGfjCCBGagAwIBAgITfgAAAB64lTWnpHAKdwAAAAAAHjANBgkq

# hkiG9w0BAQsFADBFMRMwEQYKCZImiZPyLGQBGRYDQ09NMRcwFQYKCZImiZPyLGQB

# GRYHTlBQRE5FVDEVMBMGA1UEAxMMTlBQRCBSb290IENBMB4XDTE3MDIxNjE3MzMy

# MloXDTI2MDQxMjE1MDkyMlowSDETMBEGCgmSJomT8ixkARkWA2NvbTEXMBUGCgmS

# JomT8ixkARkWB25wcGRuZXQxGDAWBgNVBAMTD05QUERJc3N1aW5nQ0EwNDCCASIw

# DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOXe5B2JHpAAEzLgy24VkpOqj+ZO

# a/7yr50h5YIbX3h5gBybFmiLPtIVq+HBhxmhtPoQ63RCTv6S+sDMyFgUilqos2DO

# TusRCb4bv/0YODGSqZn+GlXULeC5wzzENmS0X2cz/9ld4RQ0XH4x3aUFfStMvkte

# 9yd4cCCC1ZnZQLMJOhWTxVpYy7D/I4RqUuQ4stBNsvbz1oAQLygnhGqmuOEGzJF8

# 32d7y2uyTAVPvxQm/7q7+VZTsAMuDPaFvP7I4nv0XPPxWYwqtA1h5bKGttj3AoaT

# odckmwVwBWwo3gH4cbHTC7rfjEFcMQplqD1WHNYzyVlKrsq/q9RnZKRvO1MCAwEA

# AaOCAmIwggJeMBIGCSsGAQQBgjcVAQQFAgMCAAIwIwYJKwYBBAGCNxUCBBYEFOlz

# eL6Rr6Hsy5CLV3/qQs1sx9kjMB0GA1UdDgQWBBRIVWAIn/bzEeBFTdd0Rq0QE9M1

# RjCBpAYDVR0gBIGcMIGZMIGWBggrBgEEAYHHNzCBiTBUBggrBgEFBQcCAjBIHkYA

# TgBQAFAARAAgAEMAZQByAHQAaQBmAGkAYwBhAHQAZQAgAFAAcgBhAGMAdABpAGMA

# ZQAgAFMAdABhAHQAZQBtAGUAbgB0MDEGCCsGAQUFBwIBFiVodHRwOi8vd3d3Lm5w

# cGQuY29tL2NlcnRkYXRhL2Nwcy5hc3AAMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA

# QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFGoL

# RkNmrxkdscuqKeDTRJT809irMD4GA1UdHwQ3MDUwM6AxoC+GLWh0dHA6Ly93d3cu

# bnBwZC5jb20vY2VydGRhdGEvTlBQRF9Sb290X0NBLmNybDCBwgYIKwYBBQUHAQEE

# gbUwgbIwga8GCCsGAQUFBzAChoGibGRhcDovLy9DTj1OUFBEJTIwUm9vdCUyMENB

# LENOPUFJQSxDTj1QdWJsaWMlMjBLZXklMjBTZXJ2aWNlcyxDTj1TZXJ2aWNlcyxj

# bj1Db25maWd1cmF0aW9uLERDPU5QUERORVQsREM9Q09NP2NBQ2VydGlmaWNhdGU/

# YmFzZT9vYmplY3RDbGFzcz1jZXJ0aWZpY2F0aW9uQXV0aG9yaXR5MA0GCSqGSIb3

# DQEBCwUAA4ICAQBe8E00MQYC5W50b0tMisEhAc/GXj5iFSA6Zf61QwQ8ynFcwcaz

# FaNjt//iF23r1fmo/lC09jIgCsZHPQhzP0h5Dhb+LhNvv2m+Xl+hrWGGreAfzOfl

# HnbS3gX8QQpP9Td2oEyRGZj/c68OmB7hkEc5O3qRN47oRpwXZ2wA6Chp+I7RO1jz

# 42RLnEAdgyG+5CvsLg7mLg6xwPH2SAje9X2o1hc63g2fCYwAs4AfX/+yLM4OFeGs

# MRzNWDls89f3Jizk3SQW4rw6JI1O/mFTgvE0iCmzkpRoL0t+1o13vymCeOKLu6+Z

# 1VEA+LT2hUvykn8SCDXrecixg3XKDXx1wjJS6vKWj7awRwlLWW9GHGfROSWCAb5R

# Kmr+Vpsle+DIIOadKdp/8RsZ50RO8vuTbwkUyiGG/oSEQqC061iNDV5m8NyUs1yK

# l7CGQbDkXfRixRK2bEHT4f37tB/ZkHgD2wdRso6VOBRSCWzsTHPBgjSZTt/EHUq7

# tWmSiS7v0FZXCiW9KjParz+D89iYk0z0kdMTJm9utegXTP3fXpQ1BGwavz/urYy2

# eULOz7quh1hzW7fWJEsndUtHR0UCowEvAE0tZUAAsp5binmkBgUl+zFstKSmD+WF

# LrJZ8BltKMA2bRizYsXZdpQI/n+o4CwpNHT/Hf4vAQTZPWLHMKnvEX02cTGCAfcw

# ggHzAgEBMFYwSDETMBEGCgmSJomT8ixkARkWA2NvbTEXMBUGCgmSJomT8ixkARkW

# B25wcGRuZXQxGDAWBgNVBAMTD05QUERJc3N1aW5nQ0EwNAIKFf/aSAACAACzwTAJ

# BgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0B

# CQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAj

# BgkqhkiG9w0BCQQxFgQUFuNCldnXy36BHyqqknSnSwJGtLAwDQYJKoZIhvcNAQEB

# BQAEggEAvxyC1niVhSJdbfVe2Rx6UA/NC57N5Vqbx19ei1PdmjVxSLbD2/2DoYLo

# 1ZrVkwB6CkECyQniMhl3eE1uIfYLytZ+ABOck/AtbddlTR0sXWRhEa4UZJP8sLgE

# slkbxn2SuF9jsieY7TxzkD/FIqGIwl6W0Rq6DLW9jL6h7mlwJ9t+P231eyIhsqSK

# sy33OBDYDbE9H0ipFNiSRcO4BiAZA+7+o7ZJg6Xa28JkAzx2sLaUERmv8U8XdLYU

# +YNSC5wHImSxYXpjur27QYgcxeGUkrtQ07ymGci7MTQzlQpe6PARKGqy0+on740P

# rWDfJjC6eFwPJFQk0A+BEzCqwuK0jw==

# SIG # End signature block