RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
This data sheet provides the configuration information required to create a new Microsoft Exchange 2010 Powershell Agent Based connector.
Supported Software
RSA IMG version: 6.8.1 and above. Application: Microsoft Exchange 2010
Prerequisites
To make Microsoft Exchange 2013 connector working, SSH PowerShell Agent should be installed and running on the machine where Microsoft exchange 2010 is installed.
Configuration
General
Field Name Value
Name Microsoft Exchange 2010
Description Microsoft Exchange 2010 Connector
Server AFX Server
Version 1 1
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Connector Template Microsoft Exchange 2010 (under group type “Generic-Powershell-WebService”)
State Active
Export As Template N/A
Settings
Field Name Value
Endpoint Type e.g. Type of the endpoint on which the command would be running FIM, exchange etc Powershell Host Host name or an IP address on which the agent is running Name
Powershell port Port on which the agent is running
Trust-Store Path Path for the trust-store where the agent certificate has been added.
Trust-Store Password of the trust-store where the agent certificate has been added. Password
Key-Store Path Path for the key-store where the client (connector) certificate has been added.
Key-Store Password Password of the key-store where the client (connector) certificate has been added.
Version 1 2
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Screenshot:
Version 1 3
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Capabilities
Following commands are supported by RSA IMG Exchange 2010 connector:
o CreateAccount: creates a mailbox o DeleteAccount: deletes a mailbox o EnableAccount: enables a mailbox o DisableAccount: disables a mailbox o UpdateAccount: updates a mailbox o MoveAccount: moves a mailbox
For Exchange AFX adapter, 'Mailbox' verb can be used instead of 'Account' on AFX UI (user interface) e.g. CreateMailbox, DeleteMailbox etc.
Command : CreateAccount
Command Name Limitations
CreateAccount Microsoft Exchange is Active Directory dependent application. To create an account/mailbox at Exchange, first there should be an account in Active Directory
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes.
Is the parameter encrypted? No
Display Name Identity
Version 1 4
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Mapping ${Account.Name}
Description Identity/Mailbox name
Field Name Value
Parameter Name Database
Type String
Default Value N/A
Is the parameter required? Yes
Is the parameter encrypted? No
Display Name Database
Mapping Mailbox Database
Description Mailbox database name
Command Code
Field Name Value
Exchange Command Enable-Mailbox '${Identity}' -Database '${Database}'
Command : DeleteAccount
Command Name Limitations
Version 1 5
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
DeleteAccount N/A
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes
Is the parameter encrypted? No
Display Name Identity
Mapping ${Account.Name}
Description Identity/Mailbox name
Command Code
Field Name Value
Exchange Command Disable-Mailbox '${Identity}' -Confirm:$False
Command : EnableAccount
Command Name Limitations
Version 1 6
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
EnableAccount N/A
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes.
Is the parameter encrypted? No
Display Name Identity
Mapping ${Account.Name}
Description Identity/Mailbox name
Field Name Value
Parameter Name Database
Type String
Default Value N/A
Is the parameter required? Yes
Version 1 7
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Is the parameter encrypted? No
Display Name Database
Mapping Mailbox Database
Description Mailbox database name
Command Code
Field Name Value
Exchange Command Enable-Mailbox '${Identity}' -Database '${Database}'
Command : DisableAccount
Command Name Limitations
DisableAccount N/A
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes
Version 1 8
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Is the parameter encrypted? No
Display Name Identity
Mapping ${Account.Name}
Description Identity/Mailbox name
Command Code
Field Name Value
Exchange Command Disable-Mailbox '${Identity}' -Confirm:$False
Command : UpdateAccount
Command Name Limitations
UpdateAccount N/A
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes.
Version 1 9
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Is the parameter encrypted? No
Display Name Identity
Mapping ${Account.Name}
Description Identity/Mailbox name
Field Name Value
Parameter Name ForwardingAddress
Type String
Default Value N/A
Is the parameter required? Yes
Is the parameter encrypted? No
Display Name Forwarding Address
Mapping ${Account.Name}
Description Forwarding address i.e. alias to which mails should be forwarded
Command Code
Field Name Value
Exchange Command Set-Mailbox '${Identity}' -ForwardingAddress '${ForwardingAddress}'
Version 1 10
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Command : MoveAccount
Command Name Limitations
MoveAccount N/A
Input Parameters
Field Name Value
Parameter Name Identity
Type String
Default Value N/A
Is the parameter required? Yes.
Is the parameter encrypted? No
Display Name Identity
Mapping ${Account.Name}
Description Identity/Mailbox name
Field Name Value
Parameter Name Database
Type String
Version 1 11
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Default Value N/A
Is the parameter required? Yes
Is the parameter encrypted? No
Display Name Database
Mapping Name of the target database where you want to move mailbox (e.g. New Mailbox Database, EN12434 Mailbox Database etc.)
Description A target mailbox database name
Command Code
Field Name Value
Exchange Command Move-Mailbox '${Identity}' -TargetDatabase '${Database}' -Confirm:$False
Active Directory Connector Dependent Microsoft Exchange 2010 Connector
We can configure a Microsoft Exchange 2010 Connector with an Active Directory connector. With the help of this configuration, an account will be created in Active directory and then a mailbox is created in Microsoft Exchange 2010 for same account which is created in Active directory.
Steps for configuration:
1. Create a Microsoft Exchange Connector 2010 in ‘Active’ state
2. Now create an Active director connector in ‘Test’ State
3. On the Settings page of Active directory connector, in ‘Dependent Exchange Connector’ setting under miscellaneous heading, select the Microsoft Exchange 2010 connector created in step 1
4. Click OK
Version 1 12
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
Setting Exchange ‘Alias’ through Active Directory Connector-Dependent Microsoft Exchange 2010 Connector
We can configure/set value of ‘alias’ attribute of Exchange mailbox through dependent Exchange connector.
Steps for configuration:
1. Create Exchange connector in active state and associate it with Active Directory connector as mentioned in above steps. 2. Edit the Create Account command of Active directory connector and add two parameters with names exactly as ‘Exchange_Database’ and ‘Exchange_Alias’
Note : If you don’t want to provide mailbox database value, don’t create the ‘Exchange_Database’ parameter.
3. Save the changes 4. In Exchange connector, for create account/enable account command; add one parameter named ‘Alias’. Edit the command as shown below:
Version 1 13
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
5. Save the changes and execute the Create Account command with appropriate values.
Note:
1. Microsoft Exchange 2010 doesn’t allow special characters like ‘@’ in mailbox identity name. If we run a CreateAccount command in Microsoft Exchange 2010 connector, it will show an error. But if we run a CreateAccount command for Active Directory connector which is configured with Microsoft Exchange 2010 connector (i.e. dependent Exchange connector), it shows successful status message because an account is created in Active Directory and not in Microsoft Exchange 2010
Version 1 14
RSA IMG Connector Data Sheet for Microsoft Exchange 2010 PowerShell Agent Based
2. MoveAccount command (move a mailbox) moves a mailbox from current database to target database. For this, it refers to a script MoveMailbox.ps1, which is by default shipped by Microsoft Exchange server. It is assumed that the Exchange server is installed to the location 'C:\Program Files\Microsoft\...\...' so that the script will be at 'C:\Program Files\Microsoft\Exchange Server\V14\Scripts'. If this is not the default location for Exchange server, then the Move mailbox command will fail. If Exchange server is not installed to the location 'C:\Program files\Microsoft\...', we need to provide correct location of the MoveMailbox.ps1 script to the command at back end. As we are using script written by Microsoft, we can't make change in it and for negative testing of MoveMailbox command, proper exit status won't come out hence negative testing can't be performed.
Copyright © 2015 EMC Corporation. All Rights Reserved. Published in the USA.
Trademarks
RSA, the RSA Logo, and EMC are either registered trademarks or trademarks of EMC Corporation in the United States and/or other countries. All other trademarks used herein are the property of their respective owners. For a list of EMC trademarks, go to www.rsa.com/legal/trademarks_list.pdf.
Version 1 15