Getting Started

Endpoints

Patch Management

Vulnerability Management

Software Deployment & IT Assets

Automation & Remote Desktop

Real-Time Reports & Alerts

Account Access & Management

SSO Authentication

Security Concerns

Need Help?

Action1 5 Documentation 5 Custom Attributes

Custom Attributes

Custom attributes are user-defined values that can be used in dynamic endpoint group filtering. For example, you can use custom endpoint attributes to specify:

  • Warranty expiration date
  • Machine type (Laptop, Server, VM, etc.)
  • Enabled OS features, and so on.

You can define up to 30 custom endpoint attributes.

  • Attribute names are defined on the enterprise or organization level.
  • Attribute values can be defined manually for the selected endpoint, or automatically using PowerShell.

To specify attribute names:

  1. Go to Configuration | Advanced.
Custom Attributes Configuration
  1. Specify custom attribute names – for example, in the Custom Attribute 1 field, enter Machine Type.
  2. You can define attribute names for the entire Action1 Enterprise (default scope) or per organization – for that, click Add Scope.
  3. Save the settings.

To specify custom attribute values for a single endpoint:

  1. Go to Endpoints view.
  2. Click on the endpoint to display its details.
  3. On the General tab, go to the required custom attribute (Machine Type in this example) and click the Edit (“pencil”) icon.
  4. In the dialog that opens, enter the value for this endpoint (Laptop in this example) and click Save.
Custom Attributes Manual Editing

To set attribute values with Run Script automation:

To specify custom attribute values automatically, you can use Action1-Set-CustomAttribute cmdlet in PowerShell scripts run via Run Script automation:

Action1-Set-CustomAttribute “attribute name” “attribute value”

Example

PowerShell script that saves the BitLocker status into a custom attribute:

$BitlockerStatus = Get-BitLockerVolume -MountPoint env:SystemDrive−ErrorActionSilentlyContinue

$BitlockerStatusText = if ($BitlockerStatus) { BitlockerStatus.ProtectionStatus.ToString() } else { “none” }

Action1-Set-CustomAttribute “BitLocker Status” “BitlockerStatusText”;

Tip: More Custom Attributes scripts for use with Action1 are available here.

Using Custom Attributes to Populate Endpoint Groups

After you define custom endpoint attributes, they appear in the dynamic endpoint group filters, so you can use them to configure your endpoint groups. See this section for details.

Custom Attributes Group Filters

NOTE: If you change custom attribute names, you will need to update your endpoint group filters accordingly.