Share via


Get-SCOMAgentlessManagedComputer

Gets managed computers that do not have Operations Manager agents.

Syntax

Empty (Default)

Get-SCOMAgentlessManagedComputer
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgentManagedBy

Get-SCOMAgentlessManagedComputer
    [-ManagedByAgent] <AgentManagedComputer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementServerManagedBy

Get-SCOMAgentlessManagedComputer
    [-ManagedByManagementServer] <ManagementServer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromName

Get-SCOMAgentlessManagedComputer
    [-DNSHostName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

The Get-SCOMAgentlessManagedComputer cmdlet gets managed computers that do not have System Center - Operations Manager agents.

Examples

Example 1: Get agentless managed computers by using a name

PS C:\>Get-SCOMAgentlessManagedComputer -DNSHostName "server01","server0*"

This command gets the agentless managed computer named server01 and agentless managed computers that have a name that begins with server0.

Example 2: Get agentless managed computers managed by an agent

PS C:\>Get-SCOMAgent -DNSHostName "contoso01" | foreach {Get-SCAgentlessManagedComputer -ManagedByAgent $_}

This command gets a list of agentless computers managed by Operations Manager agent. The command uses the Get-SCOMAgent cmdlet to get the Operations Manager agent named contoso01, and passed the result to the Foreach-Object cmdlet. The command gets all agentless managed computers managed by the Operations Manager agent named contoso01.

Parameters

-ComputerName

Specifies an array of names of 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 running on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DNSHostName

Specifies the name of a Domain Name System (DNS) host.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name

Parameter sets

FromName
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-ManagedByAgent

Specifies an array of AgentManagedComputer objects. This parameter specifies the Operations Manager agent that performs agentless monitoring. The action account of the agent that performs the monitoring must have local administrative rights on the computer that it monitors.

To obtain an AgentManagedComputer object, use the Get-SCOMAgent cmdlet.

Parameter properties

Type:

AgentManagedComputer[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromAgentManagedBy
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ManagedByManagementServer

Specifies a ManagementServer object. This parameter specifies the primary management server that performs agentless monitoring of the agentless managed computers. To obtain a ManagementServer object, use the Get-SCOMManagementServer cmdlet.

Parameter properties

Type:

ManagementServer[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromManagementServerManagedBy
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SCSession

Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCOMManagementGroupConnection cmdlet.

A connection object represents a connection to a management server. The default is the current management group connection.

Parameter properties

Type:

Connection[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.