Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

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:

NameFormatScript UsageUsage 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;
}