Get-SCOMAgentlessManagedComputer

Get-SCOMAgentlessManagedComputer

Gets managed computers that do not have Operations Manager agents.

Syntax

Parameter Set: Empty
Get-SCOMAgentlessManagedComputer [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

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

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

Parameter Set: FromName
Get-SCOMAgentlessManagedComputer [-DNSHostName] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Detailed Description

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

Parameters

-ComputerName<String[]>

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 (.).

You must run the System Center Data Access service on the target computer before you use this cmdlet. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Credential<PSCredential>

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 value is the current user.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-DNSHostName<String[]>

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

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-ManagedByAgent<AgentManagedComputer[]>

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.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ManagedByManagementServer<ManagementServer[]>

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-Get-SCOMManagementServer cmdlet.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-SCSession<Connection[]>

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 value is the current management group connection.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get agentless managed computers by using a name

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

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

Example 2: Get agentless managed computers managed by an agent

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.

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

Add-SCOMAgentlessManagedComputer

Remove-SCOMAgentlessManagedComputer

Set-SCOMAgentlessManagedComputer

Get-Credential

Get-SCOMAgent

Get-SCOMManagementGroupConnection

Get-SCOMManagementServer

ForEach-Object