Method

GetQuarantineStatus

ModuleSecurity
LibrarySecurity
Action


Gets the current quarantine status of the device.


Ensure you understand the impact of using the Quarantine feature.


Parameters
Return values

Status (string): The quarantine status. This can be one of four values:

  • Quarantined: The device is currently under quarantine
  • NotQuarantined: The device is not currently under quarantine
  • UnknownValue: The device may be under quarantine, but persistent storage may be damaged, as some values are unexpected
  • UnknownNoSPS: The device is unable to read its persistent storage. Quarantine status is unknown, and the device cannot be quarantined (or unquarantined) until persistent storage is available.
Example


Security.GetQuarantineStatus();


Platforms
  • Windows
Notes
  • This is not available on Windows XP.
  • Quarantine requires working persistent storage.
    • If persistent storage is removed or corrupted during quarantine, the agent will be unable to revert to an unmodified state.
  • Upgrading the agent whilst under quarantine is not supported or recommended.