---
title: "Acquire Server"
---
Acquires a server from a resource pool defined by a server role. This operation is affected by execution priority.
Acquire-Server(
	[Role: <text>],
	[ServerName: <text>],
	[Verbose: <true/false>],
	[DoNotShare: <true/false>]
);
This operation may be prefixed with Core::, although this is a built-in namespace and isn't really necessary.
| 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 | Default value is "$AcquiredServerName". | 
| Log verbose | true/false | Verbose | |
| Do not share | true/false | DoNotShare | Do not share this server between multiple AcquireServerOperation uses in this execution. This means that you must call Release Server in order to acquire the same server before the execution finishes. | 
# acquires a server associated with the build-servers role
Acquire-Server( 
   Role: build-servers,
   ServerName => $AcquiredServerName
);
for server $AcquiredServerName
{
    Log-Information Acquired server: $ServerName;
}