AdtAdmin.exe /UpdForwarder

 

Updated: May 13, 2016

Applies To: System Center 2012 R2 Operations Manager, System Center 2012 - Operations Manager, System Center 2012 SP1 - Operations Manager

Using the /UpdForwarder parameter, you can change the name and the value of an ACS forwarder and also change the group membership of an ACS forwarder.

Syntax

AdtAdmin.exe /UpdForwarder [/Collector:<CollectorName>] {/Forwarder:<Name> | /ForwarderID:<ForwarderIDNumber> | /ForwarderSid:<SID> | /Group:<GroupName> | /GroupID:<IdentificationNumber> | /GroupValue:<ValueNumber> | /Value:<ValueNumber>} {/Name:<NewName> | /Value:<NewValueNumber> /GroupValue:<NewValue>}

Subparameter

Definition

/Collector:CollectorName

Specifies the ACS collector to which the ACS forwarder or forwarders sends audit events. If this subparameter is omitted, the local ACS collector is assumed.

/Forwarder:Name

Specifies an ACS forwarder by its computer name.

/ForwarderID:ForwarderIDNumber

Specifies an ACS forwarder by its identification number. An identification number is assigned to an ACS forwarder when it first connects to the ACS collector.

/ForwarderSID:SID

Specifies an ACS forwarder by its computer security identification number.

/Group:GroupName

Specifies a group of ACS forwarders by the group’s name.

/GroupID: IdentificationNumber

Specifies a group of ACS forwarders by the group’s identification number. An identification number is assigned to a group when it is first created.

/Value:ValueNumber

Specifies an ACS forwarder or ACS group by its assigned connection value. The ACS collector prioritizes connections from ACS forwarders using connection values. Connection values range from -1 through 99. A value of -1 means the forwarder is part of an ACS group and that the group's value is used to determine the forwarder's priority. A value of 0 means the ACS collector ignores data from that ACS forwarder or group. If event saturation is detected, a collector will disconnect forwarders or a group of forwarders with lower values before disconnecting forwarders with higher values.

/GroupValue:NewValue

Specifies a new value for a group to which the ACS forwarder belongs.

/Name:NewName

Specifies a new name for the ACS forwarder.

/Value:NewValueNumber

Specifies a new value for the ACS forwarder.

Example

In this example, an ACS forwarder identified as Server1 has a current connection value of 5. This connection value is changed to 3:

adtadmin /updforwarder /forwarder:Server1 /value:5 /value:3

In this example, an ACS forwarder named "Accounting Computer" is assigned a new configuration value of 99:

adtadmin /updforwarder /forwarder:"Accounting Computer" /value:99

In this example, a group that contains the ACS forwarder named "Accounting Computer" is assigned a new configuration value of 2:

adtadmin /updforwarder /forwarder:"Accounting Computer" /groupvalue:2

In this example, the connection value of a group, specified by its identification number, is changed to 50:

adtadmin /updforwarder /forwarderid:1 /value:50

Note

An ACS forwarder can be a member of only one group at a time. If the ACS forwarder is already a member of an ACS group, running this command removes the forwarder from that group. All names with spaces must be contained within parentheses.