With the re-branding of AutoMate BPA to AutoMate Enterprise, I figured it would be appropriate to rename the PowerShell module. Along with this are some pretty serious changes to the module:
- Most objects have had classes defined for them, and are no longer of the PSCustomObject type. This allowed me to defined which properties use enums, and makes the display of these objects much more readable. For example, many objects have a "CompletionState" property (which is the Staging level) that, prior to this version, would simply display a number. That number corresponded with a staging level, but there was no great way to determine what that level was. With AutoMatePS, if an object has a staging level of Production, it will say "Production" instead of "2".
- Adds functions for working with the new Email condition introduced in v11.
- Adds functions for working with Workflow/Task/Agent properties.
- Get-AMMetric is a new function for retrieving metrics from AutoMate.
- Several enhancements to the connection store and connect function:
- AutoMatePS has been redesigned to allow connections to multiple AutoMate instances running on the same server (in theory, although I don't have this setup, so have been unable to test). A new -ConnectionAlias parameter has been added to provide a shorthand way to refer to an AutoMate server. Each connection is now uniquely identified by the hostname and port (PoshBPA only used the hostname) and has a connection alias of <server>:<port> by default, which can be cumbersome to type if you're working frequently with multiple connections. The connection alias makes this easier. Most functions have a -Connection parameter that will take either the alias or a connection object.
- Connect-AMServer now returns a connection object that can be optionally used with the -Connection parameter available on many functions.
- The connection store now stores the port. Once a server/port/credential combination is stored in the connection store, only the server needs to be specified to establish connection. This is convenient for dealing with the port differences between versions.
- The v11 port (9708) is now the default port used in Connect-AMServer.
One goal with AutoMatePS has been to make it so the user needs to rarely think about which AutoMate version they are working with. The only times you should have to think about it is when you're connecting, or if you're trying to do something that is unsupported on the version you're connected to. For example, Email conditions were introduced in version 11, so New-AMEmailCondition would not work on any version 10 servers. Another example: copying tasks with Copy-AMTask between servers is no longer supported if those servers are of different versions. This is because the module is not capable of converting between AML versions.
Given that all the functions have been renamed, any scripts that used PoshBPA will need to be modified for AutoMatePS. Additionally, pay attention to any scripts that work with multiple server connections. You will need to consider the changes outlined above for connecting to a server. Single server connections are still as easy as they were with PoshBPA.
To install from the PowerShell gallery: