Come and Check our BETA Alpha version of Powershellcenter.net
Send me your comment to Powershell@powershellcenter.com

Synopsis

Changes the managing Resource Pool for the specified managed UNIX or Linux computers.

Syntax

Set-SCXResourcePool -Agent <Computer[]> -ResourcePool <ManagementServicePool> [-ComputerName <string>] [-Credential <PSCredential>] [-Confirm] [-WhatIf] [<CommonParameters>]

Detailed Description

The Set-SCXResourcePool cmdlet changes the managing Resource Pool for the specified target managed UNIX or Linux computers. If the specified UNIX or Linux computer is already assigned to the Resource Pool, no action will be performed. The output of this cmdlet is an array of managed UNIX or Linux computer objects representing the target systems that were successfully set to a new Resource Pool.

Parameters

-Agent [<Computer[]>]

Specifies one or more managed UNIX/Linux computer objects. This parameter is accepted from the pipeline.

For information about how to get a managed UNIX/Linux computer object, type Get-Help Get-SCXAgent.

Required?   true
Position?   named
Default value?  
Accept pipeline input?   true (ByValue)
Accept wildcard characters?   false

-ComputerName [<string>]

Specifies a computer to establish a connection with. The computer must be running the Operations Manager Data Access service.

Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name. To specify the local computer, type the computer name, "localhost", or a dot (.).

Required?   false
Position?   named
Default value?  
Accept pipeline input?   false
Accept wildcard characters?   false

-Credential [<PSCredential>]

Specifies a user account under which the management group connection will run. The default is the current user.

Type a user name, such as "User01", "Domain01\User01", or "User@Domain.com", or enter a PSCredential object, such as one returned by the Get-Credential cmdlet. When you type a user name, you will be prompted for a password. For more information, type Get-Help Get-Credential.

Required?   false
Position?   named
Default value?  
Accept pipeline input?   false
Accept wildcard characters?   false

-ResourcePool [<ManagementServicePool>]

Specifies a resource pool of servers, one of which is assigned to be the current management server and the other serving as back-up management servers. This parameter requires a resource pool object and returns only the managed computers in that resource pool.

For information about how to get a resource pool object, type Get-Help Get-SCOMResourcePool.

Required?   true
Position?   named
Default value?  
Accept pipeline input?   false
Accept wildcard characters?   false

-Confirm [<SwitchParameter>]

Prompts you for confirmation before executing the command.

Required?   false
Position?   named
Default value?  
Accept pipeline input?   false
Accept wildcard characters?   false

-WhatIf [<SwitchParameter>]

Describes what would happen if you executed the command without actually executing the command.

Required?   false
Position?   named
Default value?  
Accept pipeline input?   false
Accept wildcard characters?   false

Input Type

Return Type

Microsoft.Unix.Computer[]

The Set-SCXManagementServer cmdlet outputs an array of managed UNIX/Linux computer objects with an object for each agent successfully migrated. Managed UNIX/Linux computers that are not successfully migrated to a new Resource Pool will not be output.

Notes

Examples

EXAMPLE 1

PS> $MyPool = Get-SCOMResourcePool -DisplayName "Pool 1" Get-SCXAgent -Name scxserver1.contoso.com | Set-SCXResourcePool -ResourcePool $MyPool

Description

-----------

#Moves a single agent to the Resource Pool named: "Pool 1".

EXAMPLE 2

PS> $MyPool1 = Get-SCOMResourcePool -DisplayName "Pool 1" $MyPool2 = Get-SCOMResourcePool -DisplayName "Pool 2" $MyAgents = Get-SCXAgent -ResourcePool $MyPool1 Set-SCXResourcePool -Agent $MyAgents -ResourcePool $MyPool2

Description

-----------

#Moves all UNIX and Linux agents from "Pool 1" to "Pool 2".