<< 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: 203
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."