Get-SCXAgent
Gets a list of managed UNIX and Linux computers in a management group.
Syntax
Get-SCXAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCXAgent
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCXAgent
-ID <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCXAgent
-ResourcePool <ManagementServicePool>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Description
The Get-SCXAgent cmdlet retrieves the managed UNIX and Linux computers that match the provided selection criteria. If no selection criteria are specified, all managed UNIX and Linux computers in the management group are returned.
Results are returned as an array of managed UNIX and Linux computer objects.
Examples
Example 1: Return managed UNIX and Linux computers
PS C:\>Get-SCXAgentThis command returns all managed UNIX and Linux computers in the resource pool.
Example 2: Return managed UNIX and Linux computers from a resource pool
PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePoolThe first command gets a resource pool by using the Get-SCOMResourcePool cmdlet, and stores it in the $ResourcePool variable.
The second command returns all managed UNIX and Linux computers for the resource pool in $ResourcePool.
Example 3: Return managed UNIX and Linux computers by using the name
PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"This command returns managed UNIX and Linux computers with names that match a provided list of strings.
Example 4: Return managed UNIX and Linux computers by using the pipeline
PS C:\>"server1", "server2", "server3" | Get-SCXAgentThis command provides the Name parameter through the pipeline.
Example 5: Connect to a resource pool and get a managed computer by name
PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"This command connects to a resource pool with a temporary connection, by using the current user's credentials, and returns only the managed computers that match the Name property.
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 (.).
The System Center Data Access service must be active on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifies the user account under which the management group connection runs.
Specify a PSCredential object, such as one that the Get-Credential cmdlet returns, for this parameter.
For more information about credential objects, 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 |
-ID
Specifies the ID of a managed UNIX or Linux computer object. Returns only the only managed computers with ID properties that match this value. This parameter is accepted from the pipeline.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifies a list of fully qualified domain names for one or more managed UNIX and Linux computers. Returns only the managed computers that match the Name property.
You can include wildcards, in which case all computers matching the wildcard are returned.
For information about using wildcards, type Get-Help About_Wildcards.
This parameter is accepted from the pipeline.
| Type: | String[] |
| Aliases: | DisplayName |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourcePool
Specifies a resource pool of servers, one of which is assigned to be the current management server and the other serving as backup 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 SCOMResourcePool object, type Get-Help Get-SCOMResourcePool.
| Type: | ManagementServicePool |
| Aliases: | RP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Specifies an array of Connection objects. To get Connection objects, use the Get-SCOMManagementGroupConnection cmdlet.
If this parameter is not specified, the cmdlet uses the active persistent connection to a management group.
Use the SCSession parameter to specify a different persistent connection.
You can create a temporary connection to a management group by using the ComputerName and Credential parameters.
For more information, type Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Microsoft.Unix.Computer[]
This cmdlet returns one or more Computer objects that represent managed UNIX and Linux computers when the UNIX and Linux computers match input criteria.