mirror of
https://github.com/admindroid-community/powershell-scripts.git
synced 2025-12-17 16:35:19 +00:00
211 lines
9.9 KiB
PowerShell
211 lines
9.9 KiB
PowerShell
<#
|
|
=============================================================================================
|
|
Name: Remove email forwarding in Office 365
|
|
Version: 1.0
|
|
Website: m365scripts.com
|
|
For detailed script execution: https://m365scripts.com/exchange-online/remove-email-forwarding-in-office-365-using-powershell/
|
|
============================================================================================
|
|
#>
|
|
Param
|
|
(
|
|
[Parameter(Mandatory = $false)]
|
|
[string]$UserName = $NULL,
|
|
[string]$Password = $NULL,
|
|
[string]$Name = $NULL,
|
|
[string]$CSV = $NULL
|
|
)
|
|
|
|
function WriteToLogFile ($message) {
|
|
$message >> $logfile
|
|
}
|
|
|
|
Function Connect_Exo {
|
|
#Check for EXO v2 module inatallation
|
|
$Module = Get-Module ExchangeOnlineManagement -ListAvailable
|
|
if ($Module.count -eq 0) {
|
|
Write-Host "Exchange Online PowerShell V2 module is not available" -ForegroundColor yellow
|
|
$Confirm = Read-Host "Are you sure you want to install module? [Y] Yes [N] No"
|
|
if ($Confirm -match "[yY]") {
|
|
Write-host "Installing Exchange Online PowerShell module"
|
|
Install-Module ExchangeOnlineManagement -Repository PSGallery -AllowClobber -Force
|
|
}
|
|
else {
|
|
Write-Host "EXO V2 module is required to connect Exchange Online.Please install module using Install-Module ExchangeOnlineManagement cmdlet."
|
|
Exit
|
|
}
|
|
}
|
|
Write-Host "Connecting to Exchange Online..."
|
|
#Storing credential in script for scheduling purpose/ Passing credential as parameter - Authentication using non-MFA account
|
|
if (($UserName -ne "") -and ($Password -ne "")) {
|
|
$SecuredPassword = ConvertTo-SecureString -AsPlainText $Password -Force
|
|
$Credential = New-Object System.Management.Automation.PSCredential $UserName, $SecuredPassword
|
|
Connect-ExchangeOnline -Credential $Credential
|
|
}
|
|
else {
|
|
Connect-ExchangeOnline
|
|
}
|
|
}
|
|
|
|
Function GetMailboxForwardingInfoAndRemoveForwarding {
|
|
$MailboxInfo = Get-Mailbox $Name | Where-Object { $_.ForwardingSMTPAddress -ne $Empty -or $_.ForwardingAddress -ne $Empty }
|
|
if ($MailboxInfo.count -ne 0) {
|
|
$MailboxOwner = $MailboxInfo.Name
|
|
Write-Progress -Activity "Processing Mailbox Forwarding for the User: $MailboxOwner" " "
|
|
$global:ReportSize1 = $global:ReportSize1 + 1
|
|
$DeliverToMailbox = $MailboxInfo.DeliverToMailboxandForward
|
|
if ($null -eq $MailboxInfo.ForwardingSMTPAddress) {
|
|
$ForwardingSMTPAddress = "-"
|
|
}
|
|
else{
|
|
$ForwardingSMTPAddress = (($MailboxInfo.ForwardingSMTPAddress).split(":") | Select -Index 1)
|
|
}
|
|
if ($null -eq $MailboxInfo.ForwardingAddress) {
|
|
$ForwardTo = "-"
|
|
}
|
|
else{
|
|
$ForwardTo = $MailboxInfo.ForwardingAddress
|
|
}
|
|
#ExportResults
|
|
$ExportResult = @{'Mailbox Name' = $MailboxOwner; 'Forwarding SMTP Address' = $ForwardingSMTPAddress; 'Forward To' = $ForwardTo; 'Deliver To Mailbox and Forward' = $DeliverToMailbox }
|
|
$ExportResults = New-Object PSObject -Property $ExportResult
|
|
$ExportResults | Select-object 'Mailbox Name', 'Forwarding SMTP Address', 'Forward To', 'Deliver To Mailbox and Forward' | Export-csv -path $global:ExportCSVFileName1 -NoType -Append -Force
|
|
|
|
#Remove Forwarding
|
|
try {
|
|
Set-Mailbox $Name -ForwardingAddress $NULL -ForwardingSmtpAddress $NULL -ErrorAction Stop -WarningAction SilentlyContinue
|
|
if (($ForwardingSMTPAddress -ne "-")) {
|
|
if (($ForwardTo -ne "-")) {
|
|
WriteToLogFile "Email forwarding successfully removed from $MailboxOwner - ForwardTo: $ForwardTo ForwardingSMTPAddress:$ForwardingSMTPAddress."
|
|
}
|
|
else {
|
|
WriteToLogFile "Email forwarding successfully removed from $MailboxOwner - ForwardingSMTPAddress:$ForwardingSMTPAddress."
|
|
}
|
|
}
|
|
else {
|
|
WriteToLogFile "Email forwarding successfully removed from $MailboxOwner - ForwardTo: $ForwardTo."
|
|
}
|
|
}
|
|
catch {
|
|
WriteToLogFile "Error occured while removing email forwarding configuration from $MailboxOwner."
|
|
}
|
|
}
|
|
}
|
|
|
|
Function GetInboxRulesInfoAndDisableForwarding {
|
|
Get-InboxRule -Mailbox $Name | Where-Object { $_.ForwardAsAttachmentTo -ne $Empty -or $_.ForwardTo -ne $Empty -or $_.RedirectTo -ne $Empty } | ForEach-Object {
|
|
Write-Progress "Processing the Inbox Rule for the User: $($_.MailboxOwnerId)"
|
|
$InboxRuleInfo = $_
|
|
$MailboxOwner = $InboxRuleInfo.MailboxOwnerId
|
|
$RuleName = $InboxRuleInfo.Name
|
|
$Enable = $InboxRuleInfo.Enabled
|
|
$RedirectTo = @()
|
|
if ($null -ne $InboxRuleInfo.RedirectTo) {
|
|
foreach($Temp in $InboxRuleInfo.RedirectTo){
|
|
$RedirectTo = $RedirectTo + ((($Temp.split("[")) | Select-Object -Index 0)).Replace('"', '').Trim()
|
|
}
|
|
}
|
|
else {
|
|
$RedirectTo = "-"
|
|
}
|
|
$ForwardAsAttachment = @()
|
|
if ($null -ne $InboxRuleInfo.ForwardAsAttachmentTo) {
|
|
foreach($Temp in $InboxRuleInfo.ForwardAsAttachmentTo){
|
|
$ForwardAsAttachment = $ForwardAsAttachment + ((($Temp.split("[")) | Select-Object -Index 0)).Replace('"', '').Trim()
|
|
}
|
|
}
|
|
else {
|
|
$ForwardAsAttachment = "-"
|
|
}
|
|
$ForwardTo = @()
|
|
if ($null -ne $InboxRuleInfo.ForwardTo) {
|
|
foreach($Temp in $InboxRuleInfo.ForwardTo){
|
|
$ForwardTo = $ForwardTo + ((($Temp.split("[")) | Select-Object -Index 0)).Replace('"', '').Trim()
|
|
}
|
|
}
|
|
$global:ReportSize2 = $global:ReportSize2 + 1
|
|
$ExportResult = @{'Mailbox Name' = $MailboxOwner; 'Inbox Rule' = $RuleName; 'Forward As Attachment To' = $ForwardAsAttachment -join(","); 'Forward To' = $ForwardTo -join(","); 'Redirect To' = $RedirectTo -join(",") }
|
|
$ExportResults = New-Object PSObject -Property $ExportResult
|
|
$ExportResults | Select-object 'Mailbox Name', 'Inbox Rule', 'Forward To', 'Redirect To', 'Forward As Attachment To' | Export-csv -path $global:ExportCSVFileName2 -NoType -Append -Force
|
|
#Disable Inbox Rule
|
|
if ($Enable -eq 'True') {
|
|
try {
|
|
Disable-InboxRule -Identity $RuleName
|
|
WriteToLogFile "The Inbox rule ($RuleName) present in $MailboxOwner mailbox is disabled."
|
|
}
|
|
catch {
|
|
WriteToLogFile "Error occured, while processing the Inbox rule ($RuleName) present in $MailboxOwner"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
Connect_Exo
|
|
$global:logfile = "RemoveForwardingLogFile_" + ((Get-Date -format "MMM-dd hh-mm-ss tt").ToString()) + ".txt"
|
|
$global:ExportCSVFileName1 = "EmailForwardingConfigurationReport_" + ((Get-Date -format "MMM-dd hh-mm-ss tt").ToString()) + ".csv"
|
|
$global:ExportCSVFileName2 = "InboxRulesWithForwarding_" + ((Get-Date -format "MMM-dd hh-mm-ss tt").ToString()) + ".csv"
|
|
$global:ReportSize1 = 0
|
|
$global:ReportSize2 = 0
|
|
if (($Name -ne "")) {
|
|
GetMailboxForwardingInfoAndRemoveForwarding
|
|
GetInboxRulesInfoAndDisableForwarding
|
|
}
|
|
elseif (($CSV -ne "")) {
|
|
Import-Csv $CSV | ForEach-Object {
|
|
$Name = $_.Name
|
|
GetMailboxForwardingInfoAndRemoveForwarding
|
|
GetInboxRulesInfoAndDisableForwarding
|
|
}
|
|
}
|
|
else {
|
|
[string]$Name = Read-Host "Enter the user Name"
|
|
GetMailboxForwardingInfoAndRemoveForwarding
|
|
GetInboxRulesInfoAndDisableForwarding
|
|
}
|
|
if (((Test-Path -Path $global:ExportCSVFileName1) -ne "True") -and ((Test-Path -Path $global:ExportCSVFileName2) -ne "True") ) {
|
|
Write-Host "The given user mail is not forwarded to anyone." -ForegroundColor Green
|
|
}
|
|
else {
|
|
if ((Test-Path -Path $global:ExportCSVFileName1) -eq "True") {
|
|
if ((Test-Path -Path $global:ExportCSVFileName2) -eq "True") {
|
|
Write-Host "Following output files are generated and avaialble in the current directory" -ForegroundColor green
|
|
Write-Host "$global:ExportCSVFileName1 , $global:ExportCSVFileName2" -ForegroundColor Cyan
|
|
Write-Host "The log file available in $global:logfile" -ForegroundColor Green
|
|
$prompt = New-Object -ComObject wscript.shell
|
|
$userInput = $prompt.popup("Do you want to open output files?", 0, "Open Output File", 4)
|
|
if ($userInput -eq 6) {
|
|
Invoke-Item "$global:ExportCSVFileName1"
|
|
Invoke-Item "$global:ExportCSVFileName2"
|
|
Invoke-Item "$global:logfile"
|
|
}
|
|
}
|
|
else {
|
|
Write-Host "The output file $global:ExportCSVFileName1 is available in the current directory" -ForegroundColor Green
|
|
Write-Host "The log file available in $global:logfile" -ForegroundColor Green
|
|
$prompt = New-Object -ComObject wscript.shell
|
|
$userInput = $prompt.popup("Do you want to open output files?", 0, "Open Output File", 4)
|
|
if ($userInput -eq 6) {
|
|
Invoke-Item "$global:ExportCSVFileName1"
|
|
Invoke-Item "$global:logfile"
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
Write-Host "The output file $global:ExportCSVFileName2 is available in the current directory" -ForegroundColor Green
|
|
if ((Test-Path -Path $global:logfile) -eq "True") {
|
|
Write-Host "The log file available in $global:logfile" -ForegroundColor Green
|
|
$prompt = New-Object -ComObject wscript.shell
|
|
$userInput = $prompt.popup("Do you want to open output files?", 0, "Open Output File", 4)
|
|
if ($userInput -eq 6) {
|
|
Invoke-Item "$global:ExportCSVFileName2"
|
|
Invoke-Item "$global:logfile"
|
|
}
|
|
}
|
|
else {
|
|
$prompt = New-Object -ComObject wscript.shell
|
|
$userInput = $prompt.popup("Do you want to open output files?", 0, "Open Output File", 4)
|
|
if ($userInput -eq 6) {
|
|
Invoke-Item "$global:ExportCSVFileName2"
|
|
}
|
|
}
|
|
}
|
|
} |