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 $_}
Related topics
Add-SCOMAgentlessManagedComputer
Remove-SCOMAgentlessManagedComputer
Set-SCOMAgentlessManagedComputer