User/Get-HawkUserConfiguration.ps1
|
# Gather basic information about a user for investigation ## TODO: Anything to flag here? Folder stats ... folders that we don't normally see data in? Function Get-HawkUserConfiguration { param ( [Parameter(Mandatory = $true)] [array]$UserPrincipalName ) Test-EXOConnection Send-AIEvent -Event "CmdRun" # Verify our UPN input [array]$UserArray = Test-UserObject -ToTest $UserPrincipalName foreach ($Object in $UserArray) { [string]$User = $Object.UserPrincipalName Out-LogFile ("Gathering information about " + $User) -action #Gather mailbox information Out-LogFile "Gathering Mailbox Information" Get-Mailbox -identity $user | Out-MultipleFileType -FilePrefix "Mailbox_Info" -User $User -txt -xml Get-MailboxStatistics -identity $user | Out-MultipleFileType -FilePrefix "Mailbox_Statistics" -User $User -txt -xml Get-MailboxFolderStatistics -identity $user | Out-MultipleFileType -FilePrefix "Mailbox_Folder_Statistics" -User $User -txt -xml # Gather cas mailbox sessions Out-LogFile "Gathering CAS Mailbox Information" Get-CasMailbox -identity $user | Out-MultipleFileType -FilePrefix "CAS_Mailbox_Info" -User $User -txt -xml } <# .SYNOPSIS Gathers basic information about the provided user. .DESCRIPTION Gathers and records basic information about the provided user. * Get-Mailbox * Get-MailboxStatistics * Get-MailboxFolderStatistics * Get-CASMailbox .PARAMETER UserPrincipalName Single UPN of a user, commans seperated list of UPNs, or array of objects that contain UPNs. .OUTPUTS File: Mailbox_Info.txt Path: \<User> Description: Output of Get-Mailbox for the user File: Mailbox_Info.xml Path: \<User>\XML Description: Client XML of Get-Mailbox cmdlet File: Mailbox_Statistics.txt Path : \<User> Description: Output of Get-MailboxStatistics for the user File: Mailbox_Statistics.xml Path : \<User>\XML Description: Client XML of Get-MailboxStatistics for the user File: Mailbox_Folder_Statistics.txt Path : \<User> Description: Output of Get-MailboxFolderStatistics for the user File: Mailbox_Folder_Statistics.xml Path : \<User>\XML Description: Client XML of Get-MailboxFolderStatistics for the user File: CAS_Mailbox_Info.txt Path : \<User> Description: Output of Get-CasMailbox for the user File: CAS_Mailbox_Info.xml Path : \<User>\XML Description: Client XML of Get-CasMailbox for the user .EXAMPLE Get-HawkUserConfiguration -user bsmith@contoso.com Gathers the user configuration for bsmith@contoso.com .EXAMPLE Get-HawkUserConfiguration -UserPrincipalName (get-mailbox -Filter {Customattribute1 -eq "C-level"}) Gathers the user configuration for all users who have "C-Level" set in CustomAttribute1 #> } |