Skip to main content

ExchangePS Data Collector

The ExchangePS Data Collector uses the Exchange CMDlets to return information about the Exchange environment using PowerShell. This data collector works with Exchange 2010 and newer. The ExchangePS Data Collector comes preconfigured within the Exchange Solution. Both this data collector and the solution are available with a special Enterprise Auditor license. See the Exchange Solution topic for additional information.

Protocols

  • PowerShell

Ports

  • TCP 135
  • Randomly allocated high TCP ports

Permissions

  • Remote PowerShell enabled on a single Exchange server

  • Windows Authentication enabled for the PowerShell Virtual Directory on the same Exchange server where Remote PowerShell has been enabled

  • View-Only Organization Management Role Group

  • Discovery Search Management Role Group

  • Public Folder Management Role Group

  • Mailbox Search Role

  • Discovery Management Role

  • Organization Management Role

See the Exchange PowerShell Permissions topic for additional information.

Remote PowerShell​

The ExchangePS Data Collector will use Remote PowerShell when connecting to Exchange 2010 or newer. This behavior simulates what the Exchange Management Shell does when loading. The following PowerShell syntax is an example of how PowerShell loads the connection.

$JobUserName = '{insert domain\username}'
$JobPassword = '{insert password}'
$secpasswd = ConvertTo-SecureString $JobPassword -AsPlainText -Force
$JobCredential = New-Object System.Management.Automation.PSCredential ($JobUserName, $secpasswd)
$relaxed=New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$sess=New-PSSession -ConnectionUri 'https://{exchangeserver}/powershell?serializationLevel=Full' -ConfigurationName 'Microsoft.Exchange' -AllowRedirection -Authentication Negotiate -Credential $JobCredential -SessionOption $relaxed 
Import-PSSession $sess

See the Exchange PowerShell Permissions topic for instructions on enabling Remote PowerShell.

The Exchange Applet​

The ExchangePS Data Collector runs the Exchange Applet on the Exchange server in the following circumstances:

  • An actual Client Access Server (CAS) server isn't specified either in the global configuration (Settings > Exchange node) or on the Category page of the ExchangePS Data Collector Wizard
  • You haven't enabled Remote PowerShell for targeting Exchange 2010

The applet uses the following Exchange Snap-in:

  • Add-pssnapin Microsoft.Exchange.Management.Powershell.E2010

ExchangePS Query Configuration​

The ExchangePS Data Collector is configured through the ExchangePS Data Collector Wizard, which contains the following wizard pages:

Available pages vary according to selections made throughout the wizard.