RSA IMG Connector Data Sheet for Microsoft Exchange 2010 Powershell Agent Based
Total Page:16
File Type:pdf, Size:1020Kb
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 .