Get-SCOMResourcePool
Retrieves resource pools in Operations Manager.
Syntax
Get-SCOMResourcePool
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMResourcePool
[-DisplayName] <String[]>
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMResourcePool
-Id <Guid[]>
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMResourcePool
-Name <String[]>
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMResourcePool
[-Member] <ComputerHealthService[]>
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMResourcePool
[-Observer] <ComputerHealthService[]>
[-EnableAutomaticMembership <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Description
The Get-SCOMResourcePool cmdlet retrieves resource pools in System Center - Operations Manager. A resource pool enables a collection of management servers to distribute the workload.
Examples
Example 1: Retrieve all resource pools by name
PS C:\>Get-SCOMResourcePool -DisplayName "*Management*", "All*"This command uses the Get-SCOMResourcePool cmdlet to get the resource pools with Management in their display name and resource pool names that begin with the string All.
Example 2: Retrieve resource pool by IDs
PS C:\>Get-SCOMResourcePool -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd, 2ef74789-f9f5-46b0-af70-16d01d4f4577This command uses the Get-SCOMResourcePool cmdlet to get the resource pools with the IDs 7413b06b-a95b-4ae3-98f2-dac9ff76dabd and 2ef74789-f9f5-46b0-af70-16d01d4f4577.
Example 3: Retrieve resource pools by member name
PS C:\>$Member = Get-SCOMManagementServer -Name "Member01"
PS C:\> Get-SCOMResourcePool -Member $MemberThis example retrieves resource pools by display name.
The first command uses the Get-SCOMManagementServer cmdlet to get the member with the display name Member01, and stores the result in the $Member variable.
The second command uses the Get-SCOMResourcePool cmdlet to return all resource pools for which the value stored in the $Member variable is a member.
Example 4: Retrieve resource pools by observer name
PS C:\>$Observer = Get-SCOMManagementServer -Name "Observer01"
PS C:\> Get-SCOMResourcePool -Observer $ObserverThis example retrieves resource pools by display name.
The first command uses the Get-SCOMManagementServer cmdlet to get the observer with the display name Observer01, and stores the result in the $Observer variable.
The second command uses the Get-SCOMResourcePool cmdlet to return all resource pools for which the value stored in the $Observer variable is an observer.
Parameters
-ComputerName
Specifies an array of names of computers. The cmdlet establishes temporary connections with management groups for these computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifies a PSCredential object for the management group connection.
To obtain a PSCredential object, use the Get-Credential cmdlet.
For more information, type "Get-Help Get-Credential".If you specify a computer in the ComputerName parameter, use an account that has access to that computer.
The default is the current user.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Specifies an array of display names of an object. Values of the DisplayName parameter may vary depending on which localized management packs a user imports into the management group and the locale of the user who is running Windows PowerShell.
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableAutomaticMembership
Indicates that the cmdlet returns only those resource pools for which automatic membership is enabled. These resource pools contain only management servers.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Specifies an array of GUIDs.
An object stores a GUID in the Id property for a resource pool.
To obtain the GUID of a resource pool, type "Get-SCOMResourcePool | Format-Table DisplayName, Id".
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Member
Specifies an array of objects to include in the resource pool.
Valid objects of a resource pool include management servers and gateway servers.
For information about how to get a management server object, type "Get-Help Get-SCOMManagementServer".
| Type: | ComputerHealthService[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifies an array of names of an object.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Observer
Specifies an array of management server or a gateway management server that is not a member of the resource pool.
To make a resource pool highly available, you must add a minimum of three members to the pool, or two members and one observer.
| Type: | ComputerHealthService[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCManagementGroupConnection cmdlet.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |