Disable-SCOMAgentProxy

Disables agents from acting as a proxy agent for other computers.

Syntax

Disable-SCOMAgentProxy [-Agent] <AgentManagedComputer[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

The Disable-SCOMAgentProxy cmdlet disables System Center 2016 - Operations Manager agents from acting as a proxy agents and discovering managed objects on other computers.

Examples

Example 1: Disable a proxy agent

PS C:\>"Server01.Contoso.com" | Get-SCOMAgent | Disable-SCOMAgentProxy

This command gets the Operations Manager agent named server01.contoso.com and disables it from acting as a proxy agent.

Example 2: Disable agents that act as a proxy agent

PS C:\>Get-SCOMAgent | Where-Object {$_.ProxyingEnabled.Value -eq $True} | Disable-SCOMAgentProxy

This command gets all Operations Manager agents that have the ProxyingEnabled property set to $True, and then disables the agents from acting as a proxy agent.

Parameters

-Agent

Specifies an array of AgentManagedComputer objects. This parameter specifies the Operations Manager agents to disable from acting as proxy agents. To obtain an AgentManagedComputer object, use the Get-SCOMAgent cmdlet.

Type:AgentManagedComputer[]
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-PassThru

Indicates that the cmdlet creates or modifies an object that a command can use in the pipeline. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False