PoshCode Archive  Artifact [bdfc84acea]

Artifact bdfc84aceac15d037330a5d164a8dc046b1f754b9fc4fada336cf63d962ceb1a:

• File Added-Deleted-AD-Objects.ps1 — part of check-in [89d227c80e] at 2018-06-10 12:57:04 on branch trunk — I earlier converted a VBScript written by Chrissy LeMaire to Powershell but later wanted to add in some code to include Active directory objects that have been deleted. (user: Joel De La Torre size: 4411)

# encoding: ascii
# api: powershell
# title: Added/Deleted AD Objects
# description: I earlier converted a VBScript written by Chrissy LeMaire to Powershell but later wanted to add in some code to include Active directory objects that have been deleted.
# version: 0.1
# type: function
# author: Joel De La Torre
# license: CC0
# x-poshcode-id: 142
# x-archived: 2016-03-20T09:39:31
# x-published: 2008-02-12T14:36:00
#
#
#REQUIRES -pssnapin quest.activeroles.admanagement
#REQUIRES -pssnapin Pscx

begin {

# Build variables
$strSMTPServer = "xx.xx.xx.xx";
$strEmailFrom = "AD_Admin@yourdomain.com";
$strEmailTo = "admin@yourdomain.com";
$borders = "=" * 25;
[int]$days = -60

function TombStonedObjects {
	# create Directory Searcher object and set properties to search
	# for tombstoned objects

	$ds = New-Object System.DirectoryServices.DirectorySearcher
	$ds.Tombstone = $TRUE
	$ds.Filter = "isDeleted=TRUE"

	# Query for objects and filter for DN 
	$DSResults=$DS.FindAll() | select path

	# Build simple RegExp to get just Common Name
	$r=[regex]"(?<=CN=).+(?=\\)"
	$DSR2=$DSResults | % { $r.Matches($_);$script:delCount++}
	foreach ($DSobject in $DSR2) { $delMessage += "Deleted object: " + $DSobject.value.trim() + "`n" }
	
	$delMessage
	
	# end function
	}


function AddedComputersAndUsers {
# Query AD for Computer and users created in the last 'x' amount of days.
$ADObjects=Get-QADObject | ? {$_.type -match ("computer|user")} | ? {$_.whencreated -gt ((get-date).addDays($days))}

  if ($ADObjects) {
	foreach ($ADObject in $ADObjects) {
		switch ($ADObject.Type) {
			'user'	{
				$usrCount ++;
				$ADObject | fl * | Out-Null; #This is needed for some reason some objects are not returned without it 
				$usrMessage += "Display Name: " + $ADobject.displayname + "`n";
				$usrMessage += "SAMAccountName: " + $ADObject.get_LogonName() + "`n";
				$usrMessage += "Container: " + $ADObject.parentcontainer + "`n";
				$usrMessage += "When Created: " + $ADObject.whencreated + "`n";
				$usrMessage += "Principal Name: " + $ADObject.userPrincipalName + "`n";
				$usrMessage += "Groups: `n";
					# Build array of groups and populate $usrMessage variable
					$groups=$adobject.MemberOf
					foreach ($group in $groups) { $usrMessage += "$group `n"}
				$usrMessage += "`n";
				}				
			'computer' {
				$computerCount ++;
				$ADObject | fl * | Out-Null; #This is needed for some reason some objects are not returned without it 
				$compMessage += "DNS HostName: " + $ADObject.dnsname + "`n";
				$compMessage += "OperatingSystem: " + $ADObject.osName + "`n";
				$compMessage += "OS Service Pack: " + $ADObject.osservicepack + "`n";
				$compMessage += "Computer Role: " + $ADObject.computerrole + "`n";
				$compMessage += "When Created: " + $ADObject.whencreated + "`n";
				$compMessage += "Container: " + $ADObject.parentcontainer + "`n";
				$compMessage += "`n";
				}
			}
		}
	
	$deletedobjects = TombStonedObjects
	
	# Build emailBody with the Usermessage and ComputerMessage variables 
	$script:emailMessage = "AD User/Computer Objects created in the last " + [math]::abs($days) + " day(s).`n";
	if ($usrMessage) {$script:emailMessage += "$borders Users $borders`n" + $usrMessage;}
	if ($compMessage) {$script:emailMessage += "$borders Computers $borders`n" + $compMessage;}
	if ($deletedobjects) {$script:emailMessage += "$borders Deleted Objects for the last 60 days $borders `n" + $deletedobjects;}
	$script:emailSubject = "Users Added: " + $usrCount + ". Computers Added: " + $computerCount + ".  Objects Deleted: " + $script:delCount + ".";
	
	}
	
	else {
	# No users or computers found created in the last 'x' days.
	$deletedobjects = TombStonedObjects
	$script:emailSubject = "Users Added: " + $usrCount + ". Computers Added: " + $computerCount + ".  Objects Deleted: " + $script:delCount + ".";
	$script:emailMessage = "No Users or Computers have been added in the last " + [math]::abs($days) + " day(s). `n";
	if ($deletedobjects) {$script:emailMessage += "$borders Deleted Objects for the last 60 days $borders `n" + $deletedobjects;}
		}
	# end function
	}
# end Begin
}


process {


AddedComputersAndUsers
Send-SmtpMail -Subject $script:emailSubject -To $strEmailTo -From $strEmailFrom -SmtpHost $strSMTPServer -Body $script:emailMessage;

# end Process
}