Acquire Server
- 14 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Acquire Server
- Updated on 14 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
This is generated from the built in components of Otter 3.0.0, and may be different than what you have installed (especially if you have extensions); go to [User Icon] -> Documentation within your BuildMaster instance to see exactly what operations are available.
Acquire Server
Acquires a server from a resource pool defined by a server role.
Script usage:
Acquire-Server( [Role: <text>], [ServerName: <text>], [Verbose: <true/false>] );
This operation may be prefixed with Core::, although this is a built-in namespace and isn't really necessary.
Arguments:
| Name | Format | Script Usage | Usage Notes |
|---|---|---|---|
| Server role | text | Role | A server role that defines the list of servers to be used as the source of the pool. |
| ⇒ Server name output | text | ServerName | |
| Log verbose | true/false | Verbose |
Example:
# acquires a server associated with the build-servers role
Acquire-Server(
Role: build-servers,
ServerName => $AcquiredServerName
);
for server $AcquiredServerName
{
Log-Information Acquired server: $ServerName;
}
Was this article helpful?
