Get-SCOMAgentlessManagedComputer

Reference

Module:: OperationsManager

Gets managed computers that do not have Operations Manager agents.

Syntax

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

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

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

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.

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

-DNSHostName

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

Type:	String[]
Aliases:	Name
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	AgentManagedComputer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	ManagementServer[]
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-SCOMManagementGroupConnection cmdlet.

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

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False