Disable-SCOMAgentProxy

Reference

Module:: OperationsManager

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

Syntax

Disable-SCOMAgentProxy
       [-Agent] <AgentManagedComputer[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<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[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
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
Position:	2
Default value:	None
Required:	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
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False