Contents

Method

Invalidate

ModulePolicy
LibraryCore
Action

Reset this Agent to have a null/empty policy.

Warning

This method should be used for troubleshooting purposes only.
Parameters

None

Return valuesMessage (string): A message confirming the policy invalidation.
Example
Policy.Invalidate();
Platforms
  • Windows
  • Linux
  • MacOS
Notes

Introduced in v8.1.

This method immediately resets the Agent's policy to an empty one, which discards all rules and event subscriptions. If the Agent is connected to the Switch, the Agent will subsequently negotiate an appropriate policy, although this may take a few minutes to happen. If the Agent is not connected to the Switch, no policy rules or event subscriptions will be in effect, and the Agent will renegotiate a policy the next time it does connect.