<< Back to Script Library
Disable Account(s)
Disables the Active Directory account of the selected user(s)
Version: 3.0.4
Created: 2013-11-24
Modified: 2014-02-19
Creator: Zeev Eisenberg
Downloads: 200
Tags: Active Directory powershell
Created: 2013-11-24
Modified: 2014-02-19
Creator: Zeev Eisenberg
Downloads: 200
Tags: Active Directory powershell
The Script
Copy Script
Copied to clipboard
<#
.SYNOPSIS
Disables the Active Directory account of the selected user(s).
.PARAMETER Identity
The name of the user being disable - automatically supplied by CU
#>
$ErrorActionPreference = "Stop"
If ( (Get-Module -Name ActiveDirectory -ErrorAction SilentlyContinue) -eq $null )
{
Try {
Import-Module ActiveDirectory
} Catch {
# capture any failure and display it in the error section, then end the script with a return
# code of 1 so that CU sees that it was not successful.
Write-Error "Unable to load the module" -ErrorAction Continue
Write-Error $Error[1] -ErrorAction Continue
Exit 1
}
}
# Because this is the main function of the script it is put into a try/catch frame so that any errors will be
# handled in a ControlUp-friendly way.
Try {
Disable-ADAccount -Identity $args[0].split("\")[1]
} Catch {
# capture any failure and display it in the error section, then end the script with a return
# code of 1 so that CU sees that it was not successful.
Write-Error $Error[0] -ErrorAction Continue
Exit 1
}
Write-Host "$($args[0]) successfully disabled."