Share via

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