Released version 2.2.0

Updated Winscp assembly and exe to version upstream version 5.15.9
Added new function New-ExchangeConnection
Added new function Close-ExchangeSession

Author: Daniele Catanesi

CHANGELOG.md

@@ -1,8 +1,13 @@
 # IT-ToolBox - Change History
 
+## Version 2.2.0.0 - 05.12.2019
+
+- **New** cmdlet *New-ExchangeSession* to create a remote PowerShell session to an on-premise Exchange server [2](https://github.com/PsCustomObject/IT-ToolBox/issues/2)
+- **New** cmdlet *Close-ExchangeSession* to close a remote PowerShell session to an on-premise or online Exchange server
+
 ## Version 2.1.0.0 - 02.11.2019
 
-- **New** cmdlet *New-ApiRequest* to create OAuth2 api requests
+- **New** cmdlet *New-ApiRequest* to create OAuth2 API requests
 - **Fixed** comment based help for *New-StringEncryption* cmdlet
 - **Fixed** comment based help for *New-StringDecryption* cmdlet
 - **Fixed** wrong return data type for *Test-IsEmail* cmdlet

IT-ToolBox.psd1

@@ -8,32 +8,43 @@ function Close-ExchangeSession
 		Function is used to close an open session to a remote Exchange server.
 		
 		Sessions can be specified by ID or Name, by default all sessions with a ConfigurationName of Microsoft.Exchange will be returned and removed.
+		
+		Office 365 sessions will not be removed
 	
 	.PARAMETER SessionId
 		An integer value representing the Sesison ID to remove.
 	
 	.PARAMETER SessionName
 		A string value representing the Session Name to remove.
 	
+	.PARAMETER Online
+		When parameter is specified function will only close any open Exchange Online session.
+	
 	.EXAMPLE
 		PS C:\> Close-ExchangeSession
 	
 	.OUTPUTS
 		System.Boolean
 	
 	.NOTES
-		If no SessionName or SessionId parameter is used function will close any remote PowerShell session (Skype Online, Exchange Online, Sharepoint Online etc.)
-	#>
+		If no SessionName or SessionId parameter is used function will close any Exchange remote session.
+#>
 
 	[CmdletBinding(DefaultParameterSetName = 'ReturnAllSessions')]
 	param
 	(
 		[Parameter(ParameterSetName = 'SessionById')]
 		[ValidateNotNullOrEmpty()]
-		[int]$SessionId,
+		[int]
+		$SessionId,
 		[Parameter(ParameterSetName = 'SessionByName')]
 		[ValidateNotNullOrEmpty()]
-		[string]$SessionName
+		[string]
+		$SessionName,
+		[Parameter(ParameterSetName = 'ReturnAllSessions')]
+		[Parameter(ParameterSetName = 'SessionById')]
+		[switch]
+		$Online
 	)
 
 	Begin
@@ -92,26 +103,52 @@ function Close-ExchangeSession
 					# Get session by name
 					[System.Management.Automation.Runspaces.PSSession]$sessionObject = Get-PSSession -Name $SessionName
 					[string]$sessionConfiguration = $sessionObject.ConfigurationName
+					[string]$sessionComputerName = $sessionObject.ComputerName
 
-					# Check session is the correct type
-					if ($sessionConfiguration -like '*Exchange*')
+					if ($PSBoundParameters.ContainsKey('Online'))
 					{
-						$paramRemovePSSession = @{
-							Session = $sessionObject
-							Confirm = $false
+						if ($sessionConfiguration -like '*Exchange*')
+						{
+							$paramRemovePSSession = @{
+								Session = $sessionObject
+								Confirm = $false
+							}
+							
+							Remove-PSSession @paramRemovePSSession
+							
+							return $true
+						}
+						else
+						{
+							Write-Warning -Message "Session $SessionId is not a valid Exchange session!"
+							
+							return $false
 						}
-						
-						Remove-PSSession @paramRemovePSSession
-						
-						return $true
 					}
 					else
 					{
-						Write-Warning -Message "Session $SessionId is not an Exchange session"
-						
-						return $false
+						# Check session is the correct type
+						if (($sessionConfiguration -like '*Exchange*') -and
+							($sessionComputerName -notlike '*Office365*'))
+						{
+							$paramRemovePSSession = @{
+								Session = $sessionObject
+								Confirm = $false
+							}
+							
+							Remove-PSSession @paramRemovePSSession
+							
+							return $true
+						}
+						else
+						{
+							Write-Warning -Message "Session $SessionId is not a valid Exchange session!"
+							
+							return $false
+						}
 					}
 				}
+				
 				catch
 				{
 					Write-Warning -Message "No PsSession with Name $SessionName found!"
@@ -121,7 +158,6 @@ function Close-ExchangeSession
 
 				break
 			}
-			
 			'ReturnAllSessions'
 			{
 				# Get all seesions
@@ -132,21 +168,36 @@ function Close-ExchangeSession
 				{
 					# Get configuration name
 					[string]$sessionConfiguration = $session.ConfigurationName
-					[string]$sessionId = $sessionObject.ID #TODO: review this property
+					[string]$sessionId = $sessionObject.Id
+					[string]$sessionComputerName = $sessionObject.ComputerName
 
 					try
 					{
-						# Check session is the correct type
-						if ($sessionConfiguration -like '*Exchange*')
+						if ($PSBoundParameters.ContainsKey('Online'))
 						{
-							$paramRemovePSSession = @{
-								Session = $session
-								Confirm = $false
+							if ($sessionConfiguration -like '*Exchange*')
+							{
+								$paramRemovePSSession = @{
+									Session = $sessionObject
+									Confirm = $false
+								}
+								
+								Remove-PSSession @paramRemovePSSession
+							}
+							else
+							{
+								# Check session is the correct type
+								if (($sessionConfiguration -like '*Exchange*') -and
+									($sessionComputerName -notlike '*Office365*'))
+								{
+									$paramRemovePSSession = @{
+										Session = $session
+										Confirm = $false
+									}
+									
+									Remove-PSSession @paramRemovePSSession
+								}
 							}
-							
-							Remove-PSSession @paramRemovePSSession
-							
-							return $true
 						}
 					}
 					catch
@@ -155,16 +206,16 @@ function Close-ExchangeSession
 
 						return $false
 					}
+					
+					break
 				}
-				
-				break
 			}
 		}
-	}
-	
-	End
-	{
-		# Revert back setting
-		$ErrorActionPreference = $currentConfig
+		
+		End
+		{
+			# Revert back setting
+			$ErrorActionPreference = $currentConfig
+		}
 	}
 }