Export (0) Print
Expand All

AdtAdmin.exe /UpdForwarder

Updated: May 22, 2009

Applies To: Operations Manager 2007 R2, Operations Manager 2007 SP1

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

noteNote
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.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft