CheckPointHarmonyEndpoint
Checkpoint Harmony Endpoint provides a complete endpoint security solution built to protect organizations and the remote workforce from today's complex threat landscape.
Endpoint · Check Point Harmony Endpoint
Details
| ID | CheckPointHarmonyEndpoint |
|---|---|
| Provider | CheckPoint Software Technologies |
| Category | Endpoint |
| From Version | 6.10.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix XSIAM |
README
Checkpoint Harmony Endpoint provides a complete endpoint security solution built to protect organizations and the remote workforce from today’s complex threat landscape.
This integration was integrated and tested with version 1 of CheckPointHarmonyEndpoint.
Configure Check Point Harmony Endpoint in Cortex
| Parameter | Required |
|---|---|
| Base URL | True |
| Client ID | True |
| Secret Key | True |
| Trust any certificate (not secure) | False |
| Use system proxy settings | False |
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.
harmony-ep-job-status-get
Retrieves the status and result (if any) of a given asynchronous operation. A job is a way to monitor the progress of an asynchronous operation while avoiding issues that may manifest during long synchronous waits.
Base Command
harmony-ep-job-status-get
Input
| Argument Name | Description | Required |
|---|---|---|
| job_id | The ID of the operation to query the status of. Job ID will returned from most of the commands in this integration. It can be found in the context path. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.Job.data | String | The job data. |
| HarmonyEP.Job.status | String | The job status. |
Command example
#### Context Example
```json
{
"HarmonyEP": {
"Job": {
"data": {
"data": [
{
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"response": null,
"status": "DA_NOT_INSTALLED"
}
},
{
"machine": {
"id": "2",
"name": "DESKTOP-2"
},
"operation": {
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
],
"metadata": {
"count": 2,
"from": 0,
"to": 100
}
},
"status": "DONE",
"statusCode": 200,
"statusType": 2
}
}
}
Human Readable Output
Results
data status statusCode statusType data: {‘machine’: {‘id’: ‘1’, ‘name’: ‘DESKTOP-1’}, ‘operation’: {‘response’: None, ‘status’: ‘DA_NOT_INSTALLED’}},
{‘machine’: {‘id’: ‘2’, ‘name’: ‘DESKTOP-2’}, ‘operation’: {‘response’: None, ‘status’: ‘DA_NOT_INSTALLED’}}
metadata: {“from”: 0, “to”: 100, “count”: 2}DONE 200 2
harmony-ep-ioc-list
Gets a list of all Indicators of Compromise. Use the filter parameters to fetch specific IOCs.
Base Command
harmony-ep-ioc-list
Input
| Argument Name | Description | Required |
|---|---|---|
| filter | The indicator value or comment to search for. The filter is case-insensitive. For example, filter ‘efg will match IoCs ‘abcdEFG’, ‘efGGG’, and ‘yEfG’. | Optional |
| field | The Indicator of Compromise field to search by. Possible values are: iocValue, iocComment. Default is iocValue. | Optional |
| sort_direction | The way to sort the results. Possible values are: ASC, DESC. Default is DESC. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.IOC.comment | String | The IOC comment. |
| HarmonyEP.IOC.modifiedOn | Number | The time the IOC was modified. |
| HarmonyEP.IOC.value | String | The IOC value. |
| HarmonyEP.IOC.type | String | The IOC type. |
| HarmonyEP.IOC.id | String | The IOC ID. |
Command example
#### Context Example
```json
{
"HarmonyEP": {
"IOC": [
{
"comment": "test",
"id": "3",
"modifiedOn": "2024-04-03T09:15:04.182Z",
"type": "Domain",
"value": "test2.com"
},
{
"comment": "comment",
"id": "4",
"modifiedOn": "2024-05-20T13:14:28.290Z",
"type": "Domain",
"value": "test1.com"
}
]
}
}
Human Readable Output
IOC List
Showing page 1.
Current page size: 50.
Id Type Value Comment Modifiedon 3 Domain test2.com test 2024-04-03T09:15:04.182Z 4 Domain test1.com comment 2024-05-20T13:14:28.290Z
harmony-ep-ioc-update
Updates the given Indicators of Compromise with the given parameters.
Base Command
harmony-ep-ioc-update
Input
| Argument Name | Description | Required |
|---|---|---|
| ioc_id | The ID of the IOC to update. Use harmony-ep-ioc-list command to get all IOC IDs. | Required |
| comment | The IOC comment to update. | Required |
| value | The IOC value to update. | Required |
| type | The IOC type to update. Possible values are: Domain, IP, URL, MD5, SHA1. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.IOC.comment | String | The IOC comment. |
| HarmonyEP.IOC.modifiedOn | Number | The time the IOC was modified. |
| HarmonyEP.IOC.value | String | The IOC value. |
| HarmonyEP.IOC.type | String | The IOC type. |
| HarmonyEP.IOC.id | String | The IOC ID. |
Command example
!harmony-ep-ioc-update ioc_id=8 comment=test value=8.8.8.8 type=IP
Context Example
{
"HarmonyEP": {
"IOC": {
"comment": "test",
"id": "8",
"modifiedOn": "2024-06-24T06:44:49.214Z",
"type": "IP",
"value": "8.8.8.8"
}
}
}
Human Readable Output
IOC 8 was updated successfully
Id Type Value Comment Modifiedon 8 IP 8.8.8.8 test 2024-06-24T06:44:49.214Z
harmony-ep-ioc-create
Creates new Indicators of Compromise using the given parameters.
Base Command
harmony-ep-ioc-create
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | The IOC comment. | Required |
| value | The IOC value. For example, 8.8.8.8 for IP or example.com for Domain. | Required |
| type | The IOC type. Possible values are: Domain, IP, URL, MD5, SHA1. | Required |
Context Output
There is no context output for this command.
Command example
!harmony-ep-ioc-create comment=test value=1.1.1.2 type=IP
Human Readable Output
IOC was created successfully.
harmony-ep-ioc-delete
Deletes the given Indicators of Compromise by their ID.
Base Command
harmony-ep-ioc-delete
Input
| Argument Name | Description | Required |
|---|---|---|
| ids | A A comma-separated list of list of IOC IDs to delete. Use harmony-ep-ioc-list command to get all IOC IDs. | Optional |
| delete_all | Whether to delete all IOCs. This action permanently deletes all Indicators of Compromise and cannot be undone. Possible values are: true, false. Default is false. | Optional |
Context Output
There is no context output for this command.
Command example
!harmony-ep-ioc-delete ids=7
Human Readable Output
IOCs 7 was deleted successfully.
harmony-ep-policy-rule-assignments-get
Gets all entities directly assigned to the given rule.
Base Command
harmony-ep-policy-rule-assignments-get
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | The ID of the rule to get the assignments. Use harmony-ep-rule-metadata-list command to get all rule IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.Rule.Assignments.type | String | The rule assignment type. |
| HarmonyEP.Rule.Assignments.name | String | The rule assignment name. |
| HarmonyEP.Rule.Assignments.id | String | The rule assignment ID. |
Command example
!harmony-ep-policy-rule-assignments-get rule_id=1a2b
Context Example
{
"HarmonyEP": {
"Rule": {
"assignments": [
{
"id": "456",
"name": "ChromeOsLaptops",
"type": "VIRTUAL_GROUP"
}
],
"id": "1a2b"
}
}
}
Human Readable Output
Rule 1a2b assignments
Id Name Type 456 ChromeOsLaptops VIRTUAL_GROUP
harmony-ep-policy-rule-assignments-add
Assigns the specified entities to the given rule. Specified IDs that are already assigned to the rule are ignored.
Base Command
harmony-ep-policy-rule-assignments-add
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | The ID of the rule to add assignments to. Use harmony-ep-rule-metadata-list command to get all rule IDs. | Required |
| entities_ids | The entity IDs to assign. | Required |
Context Output
There is no context output for this command.
Command example
!harmony-ep-policy-rule-assignments-add rule_id=1a2b entities_ids=000
Human Readable Output
Entities [‘000’] were assigned to rule 1a2b successfully.
harmony-ep-policy-rule-assignments-remove
Removes the specified entities from the given rule’s assignments. Specified IDs that are not assigned to the rule are ignored.
Base Command
harmony-ep-policy-rule-assignments-remove
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | The ID of the rule to remove assignments from. Use harmony-ep-rule-metadata-list command to get all rule IDs. | Required |
| entities_ids | The entity IDs to remove. | Required |
Context Output
There is no context output for this command.
Command example
!harmony-ep-policy-rule-assignments-remove rule_id=1a2b entities_ids=000
Human Readable Output
Entities [‘000’] were removed from rule 1a2b successfully.
harmony-ep-policy-rule-install
Installs all policies.
Base Command
harmony-ep-policy-rule-install
Input
| Argument Name | Description | Required |
|---|---|---|
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.PolicyRuleInstall.job_id | String | The job ID of the policy installation. |
Command example
!harmony-ep-policy-rule-install job_id=976
Context Example
{
"HarmonyEP": {
"PolicyRuleInstall": {
"job_id": "976"
}
}
}
Human Readable Output
Policy was installed successfully
Job ID: 976
No entries.
harmony-ep-policy-rule-modifications-get
Gets information on modifications to a given rule. (Modifications are the additions or removal of assignments on a rule since it was last installed).
Base Command
harmony-ep-policy-rule-modifications-get
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | The ID of the rule to get the modifications of. Use harmony-ep-rule-metadata-list command to get all rule IDs. | Required |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.Rule.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.Rule.order | Number | Rule order. |
| HarmonyEP.Rule.isDefaultRule | Boolean | Whether or not the rule is the default. |
| HarmonyEP.Rule.family | String | A family in the rule-base (legacy and unified). |
| HarmonyEP.Rule.connectionState | String | Rule connection state. |
| HarmonyEP.Rule.comment | String | Rule comment. |
| HarmonyEP.Rule.assignments.type | String | Rule assignments type. |
| HarmonyEP.Rule.assignments.name | String | Rule assignments name. |
| HarmonyEP.Rule.assignments.id | String | Rule assignments ID. |
| HarmonyEP.Rule.name | String | Rule name. |
| HarmonyEP.Rule.id | String | Rule ID. |
| HarmonyEP.Rule.orientation | String | Rule policy orientation. |
Command example
!harmony-ep-policy-rule-modifications-get rule_id=1a2b job_id=999
Context Example
{
"HarmonyEP": {
"Rule": {
"connectionState": "CONNECTED",
"family": "Access",
"id": "1a2b",
"job_id": "999",
"lastModifiedBy": "talg",
"lastModifiedOn": {
"iso-8601": "2024-06-24T09:04:43.000Z",
"posix": 1719219883000
},
"modified": {
"assignments": {
"modified": false
},
"order": {
"modified": false
},
"settings": {
"modified": true
}
},
"name": "New Rule 1"
}
}
}
Human Readable Output
Rule 1a2b modification
Job ID: 999
Id Name Family Connectionstate Lastmodifiedby Job Id 1a2b New Rule 1 Access CONNECTED talg 999
harmony-ep-policy-rule-metadata-list
Gets the metadata of all rules or the given rule’s metadata. (Metadata refers to all information relating to the rule except it’s actual settings).
Base Command
harmony-ep-policy-rule-metadata-list
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | The ID of the rule to get the metadata. | Optional |
| rule_family | An optional ‘Rule Family’ filter. Used to filter the results to only the selected rule family (e.g., only ‘Threat Prevention’). Possible values are: General Settings, Threat Prevention, Data Protection, OneCheck, Deployment, Remote Access VPN, Capsule Docs, Access, Agent Settings. | Optional |
| connection_state | An optional ‘Connection State’ filter. Used to filter the results to only the selected Connection State (e.g., only rules pertaining to policies for connected clients). Possible values are: CONNECTED, DISCONNECTED, RESTRICTED. | Optional |
| limit | The maximum number of IP lists to return. Default is 50. | Optional |
| all_results | Whether to return all of the results or not. Possible values are: true, false. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.Rule.order | Number | Rule order. |
| HarmonyEP.Rule.isDefaultRule | Boolean | Whether or not the rule is the default. |
| HarmonyEP.Rule.family | String | A family in the rule-base (legacy and unified). |
| HarmonyEP.Rule.connectionState | String | Rule connection state. |
| HarmonyEP.Rule.comment | String | Rule comment. |
| HarmonyEP.Rule.assignments.type | String | Rule assignments type. |
| HarmonyEP.Rule.assignments.name | String | Rule assignments name. |
| HarmonyEP.Rule.assignments.id | String | Rule assignments ID. |
| HarmonyEP.Rule.name | String | Rule name. |
| HarmonyEP.Rule.id | String | Rule ID. |
| HarmonyEP.Rule.orientation | String | Rule policy orientation. |
Command example
!harmony-ep-policy-rule-metadata-list rule_id=1a2b
Context Example
{
"HarmonyEP": {
"Rule": {
"assignments": [
{
"id": "000",
"name": "Entire Organization",
"type": "ORGANIZATION_ROOT"
},
{
"id": "456",
"name": "ChromeOsLaptops",
"type": "VIRTUAL_GROUP"
}
],
"comment": "",
"connectionState": "CONNECTED",
"family": "Threat Prevention",
"id": "1a2b",
"isDefaultRule": true,
"name": "TalTest",
"order": 2,
"orientation": "DEVICE"
}
}
}
Human Readable Output
Rule 1a2b metadata
Id Name Family Comment Orientation Connectionstate Assignments 1a2b TalTest Threat Prevention DEVICE CONNECTED {‘id’: ‘000’, ‘name’: ‘Entire Organization’, ‘type’: ‘ORGANIZATION_ROOT’},
{‘id’: ‘456’, ‘name’: ‘ChromeOsLaptops’, ‘type’: ‘VIRTUAL_GROUP’}
harmony-ep-push-operation-status-list
Gets the current statuses of all remediation operations or if a specific ID is specified, retrieve the current status of the given remediation operation.
Base Command
harmony-ep-push-operation-status-list
Input
| Argument Name | Description | Required |
|---|---|---|
| remediation_operation_id | Remediation operations ID. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.PushOperation.adminName | String | The name of the administrator who initiated the operation. |
| HarmonyEP.PushOperation.aborted | Boolean | Indicated whether the operation was aborted by an administrator. |
| HarmonyEP.PushOperation.remainingTimeoutSeconds | Number | The amount of time, in seconds, the operation will remain active. When elapsed, no more entities will be affected. |
| HarmonyEP.PushOperation.createdOn | Date | The date and time the operation was created. |
| HarmonyEP.PushOperation.type | String | Remediation operation type. |
| HarmonyEP.PushOperation.comment | String | A comment that was provided during the operation’s creation. |
| HarmonyEP.PushOperation.id | String | The operation’s ID. |
| HarmonyEP.PushOperation.overallStatus | String | Remediation operation status. |
| HarmonyEP.PushOperation.numberOfAffectedEntities | Number | The total number of entities affected by the operation. |
Command example
!harmony-ep-push-operation-status-list remediation_operation_id=4d
Context Example
{
"HarmonyEP": {
"PushOperation": {
"aborted": true,
"adminName": "talg",
"createdOn": "2024-06-20T10:58:19.407Z",
"id": "d45",
"job_id": "3",
"numberOfAffectedEntities": 6,
"operationParameters": {
"allowPostpone": false,
"informUser": true,
"originalTimeoutSeconds": 86400,
"schedulingType": "IMMEDIATE"
},
"overallStatus": "ABORTED",
"remainingTimeoutSeconds": 0,
"type": "AM_SCAN"
}
}
}
Human Readable Output
Push operations status list
Job ID: 3
Id Type Createdon Overallstatus d45 AM_SCAN 2024-06-20T10:58:19.407Z ABORTED
harmony-ep-push-operation-get
Gets the results of a given Remediation Operation. Remediation Operations may produce results such a Forensics Report or yield status updates such as an anti-malware scan progress.
Base Command
harmony-ep-push-operation-get
Input
| Argument Name | Description | Required |
|---|---|---|
| remediation_operation_id | Remediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs. | Required |
| filter_text | Optional free text search in any of the potential response fields excluding “id”. Can be used to search for specific results, devices or IPs, for example. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-push-operation-get remediation_operation_id=4d
Context Example
{
"HarmonyEP": {
"PushOperation": [
{
"job_id": "6",
"machine": {
"id": "5s",
"name": "DESKTOP-M4OAKII"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
Human Readable Output
Push operations
Job ID: 6
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 5s DESKTOP-M4OAKII DA_NOT_INSTALLED
harmony-ep-push-operation-abort
Aborts the given remediation operation. Aborting an operation prevents it from being sent to further Harmony Endpoint Clients. Clients that have already received the operation are not affected.
Base Command
harmony-ep-push-operation-abort
Input
| Argument Name | Description | Required |
|---|---|---|
| remediation_operation_id | Remediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs. | Required |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.PushOperationAbort.job_id | String | The job ID of the remediation operation. |
Command example
!harmony-ep-push-operation-abort remediation_operation_id=93 job_id=976
Context Example
{
"HarmonyEP": {
"PushOperationAbort": {
"job_id": "976"
}
}
}
Human Readable Output
Remediation operation abort was added to the push operation list successfully
Job ID: 976
No entries.
harmony-ep-anti-malware-scan
Performs an anti-malware scan on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-anti-malware-scan
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.AntiMalwareScan.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.AntiMalwareScan.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.AntiMalwareScan.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.AntiMalwareScan.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.AntiMalwareScan.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.AntiMalwareScan.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.AntiMalwareScan.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.AntiMalwareScan.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-anti-malware-scan computer_ids=1
Context Example
{
"HarmonyEP": {
"AntiMalwareScan": {
"PushOperation": [
{
"job_id": "13",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Anti-Malware scan was added to the push operation list successfully
Job ID: 13
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-anti-malware-update
Updates the anti-malware Signature Database on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-anti-malware-update
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| update_from_ep_server | Determines whether to update from the EP server. Possible values are: true, false. Default is false. | Optional |
| update_from_cp_server | Determines whether to update from the CP server. Possible values are: true, false. Default is false. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.AntiMalwareUpdate.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.AntiMalwareUpdate.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-anti-malware-update computer_ids=1
Context Example
{
"HarmonyEP": {
"AntiMalwareUpdate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Anti-Malware Signature Database update was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-anti-malware-restore
Restores a file that was previously quarantined by the Harmony Endpoint Client’s anti-malware capability. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-anti-malware-restore
Input
| Argument Name | Description | Required |
|---|---|---|
| files | A list of file paths to restore. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.AntiMalwareRestore.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.AntiMalwareRestore.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.AntiMalwareRestore.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.AntiMalwareRestore.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.AntiMalwareRestore.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.AntiMalwareRestore.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.AntiMalwareRestore.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.AntiMalwareRestore.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-anti-malware-restore files=test computer_ids=1
Context Example
{
"HarmonyEP": {
"AntiMalwareRestore": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
File restore was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-forensics-indicator-analyze
Collects forensics data whenever a computer that matches the given query accesses or executes the given IP, URL, filename, MD5 or path. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-forensics-indicator-analyze
Input
| Argument Name | Description | Required |
|---|---|---|
| indicator_type | The indictor type to analyze. Possible values are: IP, URL, File, MD5, Path. | Required |
| indicator_value | A URL, IP, Path, File or MD5 that when accessed or executed will trigger a forensics report. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| generate_activity_logs | Determines whether to generate detailed activity logs. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.IndicatorAnalyze.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.IndicatorAnalyze.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.IndicatorAnalyze.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.IndicatorAnalyze.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.IndicatorAnalyze.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.IndicatorAnalyze.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.IndicatorAnalyze.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.IndicatorAnalyze.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-forensics-indicator-analyze indicator_type=IP indicator_value=8.8.8.8 computer_ids=1
Context Example
{
"HarmonyEP": {
"IndicatorAnalyze": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
IOC analyze was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-forensics-file-quarantine
Quarantines files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-forensics-file-quarantine
Input
| Argument Name | Description | Required |
|---|---|---|
| file_type | The forensics quarantine item type. Possible values are: PATH, INCIDENT_ID, MD5. | Required |
| file_value | The forensics quarantine item value. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.FileQuarantine.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.FileQuarantine.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.FileQuarantine.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.FileQuarantine.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.FileQuarantine.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.FileQuarantine.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.FileQuarantine.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.FileQuarantine.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-forensics-file-quarantine file_type=PATH file_value=test computer_ids=1
Context Example
{
"HarmonyEP": {
"FileQuarantine": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
File quarantine was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-forensics-file-restore
Restores previously quarantined files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-forensics-file-restore
Input
| Argument Name | Description | Required |
|---|---|---|
| file_type | The forensics quarantine item type. Possible values are: PATH, INCIDENT_ID, MD5. | Required |
| file_value | The forensics quarantine item value. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.FileRestore.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.FileRestore.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.FileRestore.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.FileRestore.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.FileRestore.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.FileRestore.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.FileRestore.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.FileRestore.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-forensics-file-restore file_type=PATH file_value=test computer_ids=1
Context Example
{
"HarmonyEP": {
"FileRestore": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
File restore was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-remediation-computer-isolate
Isolates the computers matching the given query. Isolation is the act of denying all network access from a given computer. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-remediation-computer-isolate
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ComputerIsolate.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ComputerIsolate.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ComputerIsolate.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ComputerIsolate.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ComputerIsolate.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ComputerIsolate.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ComputerIsolate.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ComputerIsolate.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-remediation-computer-isolate computer_ids=1
Context Example
{
"HarmonyEP": {
"ComputerIsolate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Remediation isolate was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-remediation-computer-deisolate
De-Isolates the computers matching the given query. De-isolating a computer restores its access to network resources. Affects only isolated computers. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-remediation-computer-deisolate
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ComputerDeisolate.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ComputerDeisolate.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ComputerDeisolate.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ComputerDeisolate.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ComputerDeisolate.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ComputerDeisolate.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ComputerDeisolate.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ComputerDeisolate.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-remediation-computer-deisolate computer_ids=1
Context Example
{
"HarmonyEP": {
"ComputerDeisolate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Remediation de-isolate was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-computer-restart
Restarts computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-computer-restart
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| force_apps_shutdown | Determines whether to force applications shutdown. Possible values are: true, false. Default is false. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ComputerRestart.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ComputerRestart.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ComputerRestart.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ComputerRestart.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ComputerRestart.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ComputerRestart.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ComputerRestart.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ComputerRestart.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-computer-restart computer_ids=1
Context Example
{
"HarmonyEP": {
"ComputerReset": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Computer reset restore was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-computer-shutdown
Shuts-down computers match the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-computer-shutdown
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| force_apps_shutdown | Determines whether to force applications shutdown. Possible values are: true, false. Default is false. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ComputerShutdown.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ComputerShutdown.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ComputerShutdown.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ComputerShutdown.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ComputerShutdown.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ComputerShutdown.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ComputerShutdown.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ComputerShutdown.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-computer-shutdown computer_ids=1
Context Example
{
"HarmonyEP": {
"ComputerShutdown": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Computer shutdown was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-computer-repair
Repairs the Harmony Endpoint Client installation on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-computer-repair
Input
| Argument Name | Description | Required |
|---|---|---|
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ComputerRepair.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ComputerRepair.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ComputerRepair.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ComputerRepair.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ComputerRepair.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ComputerRepair.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ComputerRepair.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ComputerRepair.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-computer-repair computer_ids=1
Context Example
{
"HarmonyEP": {
"ComputerRepair": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Computer repair was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-computer-list
Gets a list of computers matching the given filters. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-computer-list
Input
| Argument Name | Description | Required |
|---|---|---|
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.Computer.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.Computer.CapabilitiesInstalled | String | A list of all installed capabilities. |
| HarmonyEP.Computer.InstalledAndRunning | String | A list of installed and running capabilities. |
| HarmonyEP.Computer.ClientVersion | String | The computer client version. |
| HarmonyEP.Computer.DeployTime | String | The computer deploy time. |
| HarmonyEP.Computer.Groups | String | The computer groups. |
| HarmonyEP.Computer.type | String | The computer type. |
| HarmonyEP.Computer.userName | String | The computer user name. |
| HarmonyEP.Computer.domainName | String | The computer domain name. |
| HarmonyEP.Computer.isolationStatus | String | The computer isolation status. |
| HarmonyEP.Computer.ClientVersion | String | The computer client veraion. |
| HarmonyEP.Computer.LastLoggedInUser | String | The computer last login user. |
| HarmonyEP.Computer.osName | String | The computer operating system name. |
| HarmonyEP.Computer.osVersion | String | The computer operating system version. |
| HarmonyEP.Computer.ip | String | The computer IP address. |
| HarmonyEP.Computer.DeploymentStatus | String | The computer deployment status. |
| HarmonyEP.Computer.name | String | The computer name. |
| HarmonyEP.Computer.id | String | The computer’s unique ID. |
Command example
!harmony-ep-computer-list computer_ids=1 job_id=845
Context Example
{
"HarmonyEP": {
"Computer": {
"Computer": [
{
"client_version": "87.62.2002",
"deployment_status": "Completed",
"domain_name": ".WORKGROUP",
"groups": [
{
"id": "666",
"name": "Desktops"
},
{
"id": "222",
"name": "WinDesktops"
}
],
"id": "888",
"ip": "1.1.1.1",
"isolation_status": "Not Isolated",
"last_logged_in_user": "ntlocal",
"name": "DESKTOP-E7V07D5",
"os_name": "Microsoft Windows 10 Pro",
"os_version": "10.0-19045-SP0.0-SMP",
"type": "Desktop",
"user_name": "ntlocal"
}
],
"job_id": "845"
}
}
}
Human Readable Output
Computer list
Job ID: 845
Showing page 1.
Current page size: 50.
Id Name Ip Type Groups User Name Client Version 888 DESKTOP-E7V07D5 1.1.1.1 Desktop {‘id’: ‘666’, ‘name’: ‘Desktops’},
{‘id’: ‘222’, ‘name’: ‘WinDesktops’}ntlocal 87.62.2002
harmony-ep-agent-process-information-get
Collects information about processes on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-process-information-get
Input
| Argument Name | Description | Required |
|---|---|---|
| process_name | The name of the process to collect information on. If not provided, all running processes will be collected. | Optional |
| additional_fields | Additional process properties to collect. If not provided, only the process’s name and ID will be collected. Possible values are: SI, Handles, VM, WS, PM, NPM, Path, CPU, ExitCode, ExitTime, Handle, HandleCount, HasExited, Id, MachineName, MainModule, MainWindowHandle, MainWindowTitle, MaxWorkingSet, MinWorkingSet, Modules, NonpagedSystemMemorySize, NonpagedSystemMemorySize64, PagedMemorySize, PagedMemorySize64, PagedSystemMemorySize, PagedSystemMemorySize64, PeakPagedMemorySize, PeakPagedMemorySize64, PeakVirtualMemorySize, PeakVirtualMemorySize64, PeakWorkingSet, PeakWorkingSet64, PriorityBoostEnabled, PriorityClass, PrivateMemorySize, PrivateMemorySize64, PrivilegedProcessorTime, ProcessName, ProcessorAffinity, Responding, SafeHandle, SessionId, StandardError, StandardInput, StandardOutput, StartInfo, StartTime, SynchronizingObject, Threads, TotalProcessorTime, UserProcessorTime, VirtualMemorySize, VirtualMemorySize64, WorkingSet, WorkingSet64. | Optional |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ProcessInformation.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ProcessInformation.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ProcessInformation.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ProcessInformation.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ProcessInformation.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ProcessInformation.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ProcessInformation.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ProcessInformation.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-process-information-get computer_ids=1
Context Example
{
"HarmonyEP": {
"ProcessInformation": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Process information fetch was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-process-terminate
Terminates the given process on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-process-terminate
Input
| Argument Name | Description | Required |
|---|---|---|
| terminate_all_instances | Indicates whether to terminate all processes matching the given name. If set to true while a non-zero PID is given, only a single process with the given name AND PID may be matched. If set to false or not provided, will terminate only the first matching process. Possible values are: true, false. Default is false. | Optional |
| name | The name of the process to terminate. | Required |
| pid | The ID (PID) of the process to terminate. When used in conjunction with the name field, the PID must match the named process. If both name and PID are provided but the process matching the PID does not match the provided name, the operation will be ignored by the agent. If set to 0 or not provided, the agent will seek to terminate the process or processes as indicated by the name field. | Optional |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.ProcessTerminate.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.ProcessTerminate.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.ProcessTerminate.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.ProcessTerminate.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.ProcessTerminate.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.ProcessTerminate.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.ProcessTerminate.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.ProcessTerminate.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-process-terminate name=test computer_ids=1
Context Example
{
"HarmonyEP": {
"ProcessTerminate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
Process terminate was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-registry-key-add
Adds a given registry key and/or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-registry-key-add
Input
| Argument Name | Description | Required |
|---|---|---|
| is_redirected | Determines if the key should reside under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to ‘true, thus specifying that the registry key/value be added under the WOW6432Node. Possible values are: true, false. | Optional |
| value_data | The actual value to be added the the specified registry key. | Required |
| value_type | A registry value’s type. Possible values are: DWORD (REG_DWORD), STRING (REG_GZ). | Required |
| value_name | The name of the value to be added to the specified registry key. | Required |
| key | The full path path of the key to create or add a value to. For example, ‘SOFTWARE\Node.js\Components’. | Required |
| hive | Defines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. Possible values are: HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_USERS, HKEY_CURRENT_CONFIG. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.RegistryKeyAdd.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.RegistryKeyAdd.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.RegistryKeyAdd.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.RegistryKeyAdd.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.RegistryKeyAdd.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.RegistryKeyAdd.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.RegistryKeyAdd.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.RegistryKeyAdd.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-registry-key-add value_data=test value_type="STRING (REG_GZ)" value_name=test key=test hive=HKEY_USERS computer_ids=1
Context Example
{
"HarmonyEP": {
"RegistryKeyAdd": {
"PushOperation": {
"job_id": "54",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "88",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}
Human Readable Output
Registry key add was added to the push operation list successfully
Job ID: 54
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-registry-key-delete
Removes the given registry key or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-registry-key-delete
Input
| Argument Name | Description | Required |
|---|---|---|
| is_redirected | Determines if the key should be removed from under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to ‘true’, thus specifying that the registry key/value be removed under the WOW6432Node. Possible values are: true, false. | Optional |
| value_name | The value to remove from the key. If not provided, the entire key will be deleted. | Optional |
| key | The full path path of the key to delete or remove a value from. For example, ‘SOFTWARE\Node.js\Components’. | Required |
| hive | Defines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. Possible values are: HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_USERS, HKEY_CURRENT_CONFIG. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.RegistryKeyDelete.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.RegistryKeyDelete.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.RegistryKeyDelete.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.RegistryKeyDelete.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.RegistryKeyDelete.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.RegistryKeyDelete.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.RegistryKeyDelete.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.RegistryKeyDelete.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-registry-key-delete value_name='test' key='test' hive=HKEY_USERS computer_ids=1
Context Example
{
"HarmonyEP": {
"RegistryKeyDelete": {
"PushOperation": {
"job_id": "54",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "88",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}
Human Readable Output
Registry key delete was added to the push operation list successfully
Job ID: 54
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-file-copy
Copies the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-file-copy
Input
| Argument Name | Description | Required |
|---|---|---|
| destination_absolute_path | The absolute, full destination path. The provided path must include the target file’s name (e.g., c:\backup\backup1.txt). | Required |
| source_absolute_path | The absolute, full source path (e.g., c:\backup\backup1.txt). | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.FileCopy.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.FileCopy.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.FileCopy.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.FileCopy.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.FileCopy.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.FileCopy.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.FileCopy.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.FileCopy.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-file-copy destination_absolute_path='test.txt' source_absolute_path='test.txt' computer_ids=1
Context Example
{
"HarmonyEP": {
"FileCopy": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
File copy was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-file-move
Moves the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-file-move
Input
| Argument Name | Description | Required |
|---|---|---|
| destination_absolute_path | The absolute, full destination path. The provided path must include the target file’s name (e.g., c:\backup\backup1.txt). | Required |
| source_absolute_path | The absolute, full source path (e.g., c:\backup\backup1.txt). | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.FileMove.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.FileMove.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.FileMove.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.FileMove.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.FileMove.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.FileMove.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.FileMove.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.FileMove.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-file-move destination_absolute_path='test.txt' source_absolute_path='test.txt' computer_ids=1
Context Example
{
"HarmonyEP": {
"FileMove": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
Human Readable Output
File move was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-file-delete
Deletes the given file from the given source on computers matching the given query. This operation is risky! Use with caution as it allows you to change Harmony Endpoint protected files or registry entries that are in use by your operating system. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-file-delete
Input
| Argument Name | Description | Required |
|---|---|---|
| target_absolute_path | The absolute, full path of the file to remove. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.FileDelete.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.FileDelete.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.FileDelete.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.FileDelete.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.FileDelete.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.FileDelete.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.FileDelete.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.FileDelete.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-file-delete target_absolute_path='test.txt' computer_ids=1
Context Example
{
"HarmonyEP": {
"FileDelete": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}
Human Readable Output
File delete was added to the push operation list successfully
Job ID: 16
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-vpn-site-add
Adds the given VPN site’s configuration to computers matching the given query. Adding a VPN site allows Harmony Endpoint Clients to connect to it. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-vpn-site-add
Input
| Argument Name | Description | Required |
|---|---|---|
| remote_access_gateway_name | The remote gateway’s name. | Required |
| fingerprint | The remote gateway’s certificate fingerprint. Fingerprints are used to verify the authenticity of the gateway. | Required |
| authentication_method | Authentication methods used in conjunction with VPN site standard login. Possible values are: CERTIFICATE, P12_CERTIFICATE, USERNAME_PASSWORD, SECURID_KEY_FOB, SECURID_PIN_PAD, SOFTID, CHALLENGE_RESPONSE. | Required |
| display_name | The VPN site’s display name. | Optional |
| host | The target site’s host name or IP address. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-vpn-site-add remote_access_gateway_name='test' fingerprint='test' authentication_method=CERTIFICATE host='test' computer_ids=1
Context Example
{
"HarmonyEP": {
"VPNsiteConfigurationAdd": {
"PushOperation": {
"job_id": "67",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "23",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}
Human Readable Output
VPN site configuration remove was added to the push operation list successfully
Job ID: 67
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
harmony-ep-agent-vpn-site-remove
Removes the given VPN site’s configuration to computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
Base Command
harmony-ep-agent-vpn-site-remove
Input
| Argument Name | Description | Required |
|---|---|---|
| display_name | The display name of the VPN site to remove. If a display name was not provided during the site’s creation, the host name/IP should be used instead. | Required |
| comment | Operation comment. | Optional |
| scheduling_date_time | Start the operation on a given date and time. If not specified, defaults to ‘Now’ (i.e. immediate execution). For example, “2024-04-12 03:59”. | Optional |
| expiration_seconds | The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. | Optional |
| computer_ids | A comma-separated list of computer IDs to include in the operation. | Optional |
| computer_names | A comma-separated list of computer names to include in the operation. | Optional |
| computer_ips | A comma-separated list of computer IPs to include in the operation. | Optional |
| computer_types | A comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server. | Optional |
| computer_deployment_statuses | A comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A. | Optional |
| computer_last_connection | Computer last connection range time (start time, end time) to include in the operation. For example, “2024-01-01 07:58, 2024-04-02 02:00”. | Optional |
| filter | A comma-separated list of list of search filters according to the following template: “column_name operator ‘values_list’ “. For example, the query “computerId Contains ‘1,2,3,4’ , computerIP Exact ‘1.1.1.1’ “ will refer to computers contains ‘1’, ‘2’, ‘3’, and ‘4’ in their ID and that their IP is ‘1.1.1.1’. For more optional ‘column_name’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional ‘operator’ values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType . | Optional |
| groups_ids_to_exclude | A comma-separated list of group IDs to exclude from the operation. | Optional |
| computers_ids_to_exclude | A comma-separated list of computer IDs to exclude from the operation. | Optional |
| computers_ids_to_include | A comma-separated list of computer IDs to include in the operation. | Optional |
| inform_user | Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true. | Optional |
| allow_postpone | Determines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| interval | The interval between each poll in seconds. Minimum value is 10. Default is 30. |
Optional |
| timeout | The timeout for the polling in seconds. Default is 600. | Optional |
| job_id | The job ID to fetch data for. Hidden argument. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.job_id | String | The job ID of the remediation operation. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.id | String | The remediation operation ID. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.status | String | Describes possible states in which a push operation may be in regards to a specific device. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.status | String | Push operation response status. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.output | String | Push operation response output. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.ipAddress | String | The client device’s IPv4 address. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.name | String | The client device’s name. |
| HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.id | String | The client device’s unique ID. |
Command example
!harmony-ep-agent-vpn-site-remove display_name='test' computer_ids=1
Context Example
{
"HarmonyEP": {
"VPNsiteConfigurationRemove": {
"PushOperation": {
"job_id": "67",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "23",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}
Human Readable Output
VPN site configuration remove was added to the push operation list successfully
Job ID: 67
Showing page 1.
Current page size: 50.
Machine Id Machine Name Operation Status 1 DESKTOP-1 DA_NOT_INSTALLED
Configuration parameters
base_url— Base URL (required)credentials— Client ID (required)insecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (35)
-
harmony-ep-agent-computer-repairRepairs the Harmony Endpoint Client installation on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-computer-restartRestarts computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-computer-shutdownShuts-down computers match the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-file-copyCopies the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-file-deleteDeletes the given file from the given source on computers matching the given query. This operation is risky! Use with caution as it allows you to change Harmony Endpoint protected files or registry entries that are in use by your operating system. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-file-moveMoves the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-process-information-getCollects information about processes on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-process-terminateTerminates the given process on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-registry-key-addAdds a given registry key and/or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-registry-key-deleteRemoves the given registry key or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-vpn-site-addAdds the given VPN site's configuration to computers matching the given query. Adding a VPN site allows Harmony Endpoint Clients to connect to it. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-agent-vpn-site-removeRemoves the given VPN site's configuration to computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-anti-malware-restoreRestores a file that was previously quarantined by the Harmony Endpoint Client's anti-malware capability. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-anti-malware-scanPerforms an anti-malware scan on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-anti-malware-updateUpdates the anti-malware Signature Database on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-computer-listGets a list of computers matching the given filters. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-forensics-file-quarantineQuarantines files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-forensics-file-restoreRestores previously quarantined files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-forensics-indicator-analyzeCollects forensics data whenever a computer that matches the given query accesses or executes the given IP, URL, filename, MD5 or path. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-ioc-createCreates new Indicators of Compromise using the given parameters.
-
harmony-ep-ioc-deleteDeletes the given Indicators of Compromise by their ID.
-
harmony-ep-ioc-listGets a list of all Indicators of Compromise. Use the filter parameters to fetch specific IOCs.
-
harmony-ep-ioc-updateUpdates the given Indicators of Compromise with the given parameters.
-
harmony-ep-job-status-getRetrieves the status and result (if any) of a given asynchronous operation. A job is a way to monitor the progress of an asynchronous operation while avoiding issues that may manifest during long synchronous waits.
-
harmony-ep-policy-rule-assignments-addAssigns the specified entities to the given rule. Specified IDs that are already assigned to the rule are ignored.
-
harmony-ep-policy-rule-assignments-getGets all entities directly assigned to the given rule.
-
harmony-ep-policy-rule-assignments-removeRemoves the specified entities from the given rule's assignments. Specified IDs that are not assigned to the rule are ignored.
-
harmony-ep-policy-rule-installInstalls all policies.
-
harmony-ep-policy-rule-metadata-listGets the metadata of all rules or the given rule's metadata. (Metadata refers to all information relating to the rule except it's actual settings).
-
harmony-ep-policy-rule-modifications-getGets information on modifications to a given rule. (Modifications are the additions or removal of assignments on a rule since it was last installed).
-
harmony-ep-push-operation-abortAborts the given remediation operation. Aborting an operation prevents it from being sent to further Harmony Endpoint Clients. Clients that have already received the operation are not affected.
-
harmony-ep-push-operation-getGets the results of a given Remediation Operation. Remediation Operations may produce results such a Forensics Report or yield status updates such as an anti-malware scan progress.
-
harmony-ep-push-operation-status-listGets the current statuses of all remediation operations or if a specific ID is specified, retrieve the current status of the given remediation operation.
-
harmony-ep-remediation-computer-deisolateDe-Isolates the computers matching the given query. De-isolating a computer restores its access to network resources. Affects only isolated computers. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
-
harmony-ep-remediation-computer-isolateIsolates the computers matching the given query. Isolation is the act of denying all network access from a given computer. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.
category: Endpoint provider: CheckPoint Software Technologies commonfields: id: CheckPointHarmonyEndpoint version: -1 configuration: - name: base_url display: Base URL required: true type: 0 defaultvalue: https://cloudinfra-gw.portal.checkpoint.com - name: credentials display: Client ID required: true type: 9 displaypassword: Secret Key - name: insecure display: Trust any certificate (not secure) required: false type: 8 - name: proxy display: Use system proxy settings required: false type: 8 defaultvalue: 'false' description: Checkpoint Harmony Endpoint provides a complete endpoint security solution built to protect organizations and the remote workforce from today's complex threat landscape. display: Check Point Harmony Endpoint name: CheckPointHarmonyEndpoint script: commands: - name: harmony-ep-job-status-get description: Retrieves the status and result (if any) of a given asynchronous operation. A job is a way to monitor the progress of an asynchronous operation while avoiding issues that may manifest during long synchronous waits. arguments: - name: job_id description: The ID of the operation to query the status of. Job ID will returned from most of the commands in this integration. It can be found in the context path. required: true default: true outputs: - contextPath: HarmonyEP.Job.data description: The job data. type: String - contextPath: HarmonyEP.Job.status description: The job status. type: String - name: harmony-ep-ioc-list description: Gets a list of all Indicators of Compromise. Use the filter parameters to fetch specific IOCs. arguments: - name: filter description: The indicator value or comment to search for. The filter is case-insensitive. For example, filter 'efg will match IoCs 'abcdEFG', 'efGGG', and 'yEfG'. - name: field description: The Indicator of Compromise field to search by. defaultValue: iocValue auto: PREDEFINED predefined: - iocValue - iocComment - name: sort_direction description: The way to sort the results. defaultValue: DESC auto: PREDEFINED predefined: - ASC - DESC - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' outputs: - contextPath: HarmonyEP.IOC.comment description: The IOC comment. type: String - contextPath: HarmonyEP.IOC.modifiedOn description: The time the IOC was modified. type: Number - contextPath: HarmonyEP.IOC.value description: The IOC value. type: String - contextPath: HarmonyEP.IOC.type description: The IOC type. type: String - contextPath: HarmonyEP.IOC.id description: The IOC ID. type: String - name: harmony-ep-ioc-update description: Updates the given Indicators of Compromise with the given parameters. arguments: - name: ioc_id description: The ID of the IOC to update. Use harmony-ep-ioc-list command to get all IOC IDs. required: true default: true - name: comment description: The IOC comment to update. required: true - name: value description: The IOC value to update. required: true - name: type description: The IOC type to update. auto: PREDEFINED predefined: - Domain - IP - URL - MD5 - SHA1 required: true outputs: - contextPath: HarmonyEP.IOC.comment description: The IOC comment. type: String - contextPath: HarmonyEP.IOC.modifiedOn description: The time the IOC was modified. type: Number - contextPath: HarmonyEP.IOC.value description: The IOC value. type: String - contextPath: HarmonyEP.IOC.type description: The IOC type. type: String - contextPath: HarmonyEP.IOC.id description: The IOC ID. type: String - name: harmony-ep-ioc-create description: Creates new Indicators of Compromise using the given parameters. arguments: - name: comment description: The IOC comment. required: true - name: value description: The IOC value. For example, 8.8.8.8 for IP or example.com for Domain. required: true - name: type description: The IOC type. auto: PREDEFINED predefined: - Domain - IP - URL - MD5 - SHA1 required: true - name: harmony-ep-ioc-delete description: Deletes the given Indicators of Compromise by their ID. arguments: - name: ids description: A A comma-separated list of list of IOC IDs to delete. Use harmony-ep-ioc-list command to get all IOC IDs. isArray: true - name: delete_all description: Whether to delete all IOCs. This action permanently deletes all Indicators of Compromise and cannot be undone. defaultValue: 'false' auto: PREDEFINED predefined: - 'true' - 'false' - name: harmony-ep-policy-rule-assignments-get description: Gets all entities directly assigned to the given rule. arguments: - name: rule_id description: The ID of the rule to get the assignments. Use harmony-ep-rule-metadata-list command to get all rule IDs. required: true outputs: - contextPath: HarmonyEP.Rule.Assignments.type description: The rule assignment type. type: String - contextPath: HarmonyEP.Rule.Assignments.name description: The rule assignment name. type: String - contextPath: HarmonyEP.Rule.Assignments.id description: The rule assignment ID. type: String - name: harmony-ep-policy-rule-assignments-add description: Assigns the specified entities to the given rule. Specified IDs that are already assigned to the rule are ignored. arguments: - name: rule_id description: The ID of the rule to add assignments to. Use harmony-ep-rule-metadata-list command to get all rule IDs. required: true - name: entities_ids description: The entity IDs to assign. required: true isArray: true - name: harmony-ep-policy-rule-assignments-remove description: Removes the specified entities from the given rule's assignments. Specified IDs that are not assigned to the rule are ignored. arguments: - name: rule_id description: The ID of the rule to remove assignments from. Use harmony-ep-rule-metadata-list command to get all rule IDs. required: true default: true - name: entities_ids description: The entity IDs to remove. required: true isArray: true - name: harmony-ep-policy-rule-install description: Installs all policies. arguments: - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.PolicyRuleInstall.job_id description: The job ID of the policy installation. type: String - name: harmony-ep-policy-rule-modifications-get description: Gets information on modifications to a given rule. (Modifications are the additions or removal of assignments on a rule since it was last installed). arguments: - name: rule_id description: The ID of the rule to get the modifications of. Use harmony-ep-rule-metadata-list command to get all rule IDs. required: true default: true - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.Rule.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.Rule.order description: Rule order. type: Number - contextPath: HarmonyEP.Rule.isDefaultRule description: Whether or not the rule is the default. type: Boolean - contextPath: HarmonyEP.Rule.family description: A family in the rule-base (legacy and unified). type: String - contextPath: HarmonyEP.Rule.connectionState description: Rule connection state. type: String - contextPath: HarmonyEP.Rule.comment description: Rule comment. type: String - contextPath: HarmonyEP.Rule.assignments.type description: Rule assignments type. type: String - contextPath: HarmonyEP.Rule.assignments.name description: Rule assignments name. type: String - contextPath: HarmonyEP.Rule.assignments.id description: Rule assignments ID. type: String - contextPath: HarmonyEP.Rule.name description: Rule name. type: String - contextPath: HarmonyEP.Rule.id description: Rule ID. type: String - contextPath: HarmonyEP.Rule.orientation description: Rule policy orientation. type: String - name: harmony-ep-policy-rule-metadata-list description: Gets the metadata of all rules or the given rule's metadata. (Metadata refers to all information relating to the rule except it's actual settings). arguments: - name: rule_id description: The ID of the rule to get the metadata. - name: rule_family description: An optional 'Rule Family' filter. Used to filter the results to only the selected rule family (e.g., only 'Threat Prevention'). auto: PREDEFINED predefined: - General Settings - Threat Prevention - Data Protection - OneCheck - Deployment - Remote Access VPN - Capsule Docs - Access - Agent Settings - name: connection_state description: An optional 'Connection State' filter. Used to filter the results to only the selected Connection State (e.g., only rules pertaining to policies for connected clients). auto: PREDEFINED predefined: - CONNECTED - DISCONNECTED - RESTRICTED - name: limit description: The maximum number of IP lists to return. defaultValue: '50' - name: all_results description: Whether to return all of the results or not. auto: PREDEFINED defaultValue: 'false' predefined: - 'true' - 'false' outputs: - contextPath: HarmonyEP.Rule.order description: Rule order. type: Number - contextPath: HarmonyEP.Rule.isDefaultRule description: Whether or not the rule is the default. type: Boolean - contextPath: HarmonyEP.Rule.family description: A family in the rule-base (legacy and unified). type: String - contextPath: HarmonyEP.Rule.connectionState description: Rule connection state. type: String - contextPath: HarmonyEP.Rule.comment description: Rule comment. type: String - contextPath: HarmonyEP.Rule.assignments.type description: Rule assignments type. type: String - contextPath: HarmonyEP.Rule.assignments.name description: Rule assignments name. type: String - contextPath: HarmonyEP.Rule.assignments.id description: Rule assignments ID. type: String - contextPath: HarmonyEP.Rule.name description: Rule name. type: String - contextPath: HarmonyEP.Rule.id description: Rule ID. type: String - contextPath: HarmonyEP.Rule.orientation description: Rule policy orientation. type: String - name: harmony-ep-push-operation-status-list polling: true description: Gets the current statuses of all remediation operations or if a specific ID is specified, retrieve the current status of the given remediation operation. arguments: - name: remediation_operation_id description: Remediation operations ID. - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true outputs: - contextPath: HarmonyEP.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.PushOperation.adminName description: The name of the administrator who initiated the operation. type: String - contextPath: HarmonyEP.PushOperation.aborted description: Indicated whether the operation was aborted by an administrator. type: Boolean - contextPath: HarmonyEP.PushOperation.remainingTimeoutSeconds description: The amount of time, in seconds, the operation will remain active. When elapsed, no more entities will be affected. type: Number - contextPath: HarmonyEP.PushOperation.createdOn description: The date and time the operation was created. type: Date - contextPath: HarmonyEP.PushOperation.type description: Remediation operation type. type: String - contextPath: HarmonyEP.PushOperation.comment description: A comment that was provided during the operation's creation. type: String - contextPath: HarmonyEP.PushOperation.id description: The operation's ID. type: String - contextPath: HarmonyEP.PushOperation.overallStatus description: Remediation operation status. type: String - contextPath: HarmonyEP.PushOperation.numberOfAffectedEntities description: The total number of entities affected by the operation. type: Number - name: harmony-ep-push-operation-get description: Gets the results of a given Remediation Operation. Remediation Operations may produce results such a Forensics Report or yield status updates such as an anti-malware scan progress. arguments: - name: remediation_operation_id description: Remediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs. required: true default: true - name: filter_text description: Optional free text search in any of the potential response fields excluding "id". Can be used to search for specific results, devices or IPs, for example. - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-push-operation-abort description: Aborts the given remediation operation. Aborting an operation prevents it from being sent to further Harmony Endpoint Clients. Clients that have already received the operation are not affected. arguments: - name: remediation_operation_id description: Remediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs. required: true default: true - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.PushOperationAbort.job_id description: The job ID of the remediation operation. type: String - name: harmony-ep-anti-malware-scan description: 'Performs an anti-malware scan on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. ' arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.AntiMalwareScan.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-anti-malware-update description: 'Updates the anti-malware Signature Database on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. ' arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: update_from_ep_server description: Determines whether to update from the EP server. auto: PREDEFINED defaultValue: 'false' predefined: - 'true' - 'false' - name: update_from_cp_server description: Determines whether to update from the CP server. auto: PREDEFINED defaultValue: 'false' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.AntiMalwareUpdate.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-anti-malware-restore description: "Restores a file that was previously quarantined by the Harmony Endpoint Client's anti-malware capability. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: files description: A list of file paths to restore. required: true isArray: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.AntiMalwareRestore.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-forensics-indicator-analyze description: "Collects forensics data whenever a computer that matches the given query accesses or executes the given IP, URL, filename, MD5 or path. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: indicator_type description: The indictor type to analyze. auto: PREDEFINED predefined: - IP - URL - File - MD5 - Path required: true - name: indicator_value description: A URL, IP, Path, File or MD5 that when accessed or executed will trigger a forensics report. required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: generate_activity_logs description: Determines whether to generate detailed activity logs. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.IndicatorAnalyze.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-forensics-file-quarantine description: "Quarantines files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: file_type description: The forensics quarantine item type. auto: PREDEFINED predefined: - PATH - INCIDENT_ID - MD5 required: true - name: file_value description: The forensics quarantine item value. required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.FileQuarantine.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.FileQuarantine.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-forensics-file-restore description: "Restores previously quarantined files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: file_type description: The forensics quarantine item type. auto: PREDEFINED predefined: - PATH - INCIDENT_ID - MD5 required: true - name: file_value description: The forensics quarantine item value. required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.FileRestore.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.FileRestore.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-remediation-computer-isolate description: "Isolates the computers matching the given query. Isolation is the act of denying all network access from a given computer. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ComputerIsolate.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ComputerIsolate.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-remediation-computer-deisolate description: "De-Isolates the computers matching the given query. De-isolating a computer restores its access to network resources. Affects only isolated computers. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ComputerDeisolate.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-computer-restart description: "Restarts computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: force_apps_shutdown description: Determines whether to force applications shutdown. auto: PREDEFINED defaultValue: 'false' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ComputerRestart.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ComputerRestart.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-computer-shutdown description: "Shuts-down computers match the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: force_apps_shutdown description: Determines whether to force applications shutdown. auto: PREDEFINED defaultValue: 'false' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ComputerShutdown.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ComputerShutdown.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-computer-repair description: "Repairs the Harmony Endpoint Client installation on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ComputerRepair.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ComputerRepair.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-computer-list description: "Gets a list of computers matching the given filters. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.Computer.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.Computer.CapabilitiesInstalled description: A list of all installed capabilities. type: String - contextPath: HarmonyEP.Computer.InstalledAndRunning description: A list of installed and running capabilities. type: String - contextPath: HarmonyEP.Computer.ClientVersion description: The computer client version. type: String - contextPath: HarmonyEP.Computer.DeployTime description: The computer deploy time. type: String - contextPath: HarmonyEP.Computer.Groups description: The computer groups. type: String - contextPath: HarmonyEP.Computer.type description: The computer type. type: String - contextPath: HarmonyEP.Computer.userName description: The computer user name. type: String - contextPath: HarmonyEP.Computer.domainName description: The computer domain name. type: String - contextPath: HarmonyEP.Computer.isolationStatus description: The computer isolation status. type: String - contextPath: HarmonyEP.Computer.ClientVersion description: The computer client veraion. type: String - contextPath: HarmonyEP.Computer.LastLoggedInUser description: The computer last login user. type: String - contextPath: HarmonyEP.Computer.osName description: The computer operating system name. type: String - contextPath: HarmonyEP.Computer.osVersion description: The computer operating system version. type: String - contextPath: HarmonyEP.Computer.ip description: The computer IP address. type: String - contextPath: HarmonyEP.Computer.DeploymentStatus description: The computer deployment status. type: String - contextPath: HarmonyEP.Computer.name description: The computer name. type: String - contextPath: HarmonyEP.Computer.id description: The computer's unique ID. type: String - name: harmony-ep-agent-process-information-get description: "Collects information about processes on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: process_name description: The name of the process to collect information on. If not provided, all running processes will be collected. - name: additional_fields description: Additional process properties to collect. If not provided, only the process's name and ID will be collected. auto: PREDEFINED predefined: - SI - Handles - VM - WS - PM - NPM - Path - CPU - ExitCode - ExitTime - Handle - HandleCount - HasExited - Id - MachineName - MainModule - MainWindowHandle - MainWindowTitle - MaxWorkingSet - MinWorkingSet - Modules - NonpagedSystemMemorySize - NonpagedSystemMemorySize64 - PagedMemorySize - PagedMemorySize64 - PagedSystemMemorySize - PagedSystemMemorySize64 - PeakPagedMemorySize - PeakPagedMemorySize64 - PeakVirtualMemorySize - PeakVirtualMemorySize64 - PeakWorkingSet - PeakWorkingSet64 - PriorityBoostEnabled - PriorityClass - PrivateMemorySize - PrivateMemorySize64 - PrivilegedProcessorTime - ProcessName - ProcessorAffinity - Responding - SafeHandle - SessionId - StandardError - StandardInput - StandardOutput - StartInfo - StartTime - SynchronizingObject - Threads - TotalProcessorTime - UserProcessorTime - VirtualMemorySize - VirtualMemorySize64 - WorkingSet - WorkingSet64 isArray: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ProcessInformation.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ProcessInformation.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-process-terminate description: "Terminates the given process on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: terminate_all_instances description: Indicates whether to terminate all processes matching the given name. If set to true while a non-zero PID is given, only a single process with the given name AND PID may be matched. If set to false or not provided, will terminate only the first matching process. defaultValue: 'false' auto: PREDEFINED predefined: - 'true' - 'false' - name: name description: The name of the process to terminate. required: true default: true - name: pid description: The ID (PID) of the process to terminate. When used in conjunction with the name field, the PID must match the named process. If both name and PID are provided but the process matching the PID does not match the provided name, the operation will be ignored by the agent. If set to 0 or not provided, the agent will seek to terminate the process or processes as indicated by the name field. - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.ProcessTerminate.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.ProcessTerminate.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-registry-key-add description: "Adds a given registry key and/or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: is_redirected description: Determines if the key should reside under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to 'true, thus specifying that the registry key/value be added under the WOW6432Node. auto: PREDEFINED predefined: - 'true' - 'false' - name: value_data description: The actual value to be added the the specified registry key. required: true - name: value_type description: A registry value's type. auto: PREDEFINED predefined: - DWORD (REG_DWORD) - STRING (REG_GZ) required: true - name: value_name description: The name of the value to be added to the specified registry key. required: true - name: key description: The full path path of the key to create or add a value to. For example, 'SOFTWARE\Node.js\Components'. required: true - name: hive description: Defines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. auto: PREDEFINED predefined: - HKEY_CURRENT_USER - HKEY_LOCAL_MACHINE - HKEY_CLASSES_ROOT - HKEY_USERS - HKEY_CURRENT_CONFIG required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.RegistryKeyAdd.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-registry-key-delete description: "Removes the given registry key or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: is_redirected description: Determines if the key should be removed from under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to 'true', thus specifying that the registry key/value be removed under the WOW6432Node. auto: PREDEFINED predefined: - 'true' - 'false' - name: value_name description: The value to remove from the key. If not provided, the entire key will be deleted. - name: key description: The full path path of the key to delete or remove a value from. For example, 'SOFTWARE\Node.js\Components'. required: true - name: hive description: Defines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. auto: PREDEFINED predefined: - HKEY_CURRENT_USER - HKEY_LOCAL_MACHINE - HKEY_CLASSES_ROOT - HKEY_USERS - HKEY_CURRENT_CONFIG required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.RegistryKeyDelete.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-file-copy description: "Copies the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: destination_absolute_path description: The absolute, full destination path. The provided path must include the target file's name (e.g., c:\backup\backup1.txt). required: true - name: source_absolute_path description: The absolute, full source path (e.g., c:\backup\backup1.txt). required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.FileCopy.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.FileCopy.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-file-move description: "Moves the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: destination_absolute_path description: The absolute, full destination path. The provided path must include the target file's name (e.g., c:\backup\backup1.txt). required: true - name: source_absolute_path description: The absolute, full source path (e.g., c:\backup\backup1.txt). required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.FileMove.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.FileMove.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.FileMove.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.FileMove.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.FileMove.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.FileMove.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.FileMove.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.FileMove.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-file-delete description: "Deletes the given file from the given source on computers matching the given query. This operation is risky! Use with caution as it allows you to change Harmony Endpoint protected files or registry entries that are in use by your operating system. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: target_absolute_path description: The absolute, full path of the file to remove. required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.FileDelete.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.FileDelete.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-vpn-site-add description: " Adds the given VPN site's configuration to computers matching the given query. Adding a VPN site allows Harmony Endpoint Clients to connect to it. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: remote_access_gateway_name description: The remote gateway's name. required: true - name: fingerprint description: The remote gateway's certificate fingerprint. Fingerprints are used to verify the authenticity of the gateway. required: true - name: authentication_method description: Authentication methods used in conjunction with VPN site standard login. auto: PREDEFINED predefined: - CERTIFICATE - P12_CERTIFICATE - USERNAME_PASSWORD - SECURID_KEY_FOB - SECURID_PIN_PAD - SOFTID - CHALLENGE_RESPONSE required: true - name: display_name description: The VPN site's display name. - name: host description: The target site's host name or IP address. required: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.id description: The client device's unique ID. type: String - name: harmony-ep-agent-vpn-site-remove description: "Removes the given VPN site's configuration to computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter. " arguments: - name: display_name description: The display name of the VPN site to remove. If a display name was not provided during the site's creation, the host name/IP should be used instead. required: true default: true - name: comment description: Operation comment. - name: scheduling_date_time description: Start the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, “2024-04-12 03:59”. - name: expiration_seconds description: The amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1. - name: computer_ids description: A comma-separated list of computer IDs to include in the operation. required: false isArray: true - name: computer_names description: A comma-separated list of computer names to include in the operation. required: false isArray: true - name: computer_ips description: A comma-separated list of computer IPs to include in the operation. required: false isArray: true - name: computer_types description: A comma-separated list of computer types to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Desktop - Laptop - N/A - Domain Controller - Server - name: computer_deployment_statuses description: A comma-separated list of computer deployment statuses to include in the operation. required: false isArray: true auto: PREDEFINED predefined: - Retrying - Error - Scheduled - Downloading - Deploying - Completed - Failed - Uninstalling - Not Scheduled - Not Installed - N/A - name: computer_last_connection description: Computer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00”. required: false isArray: true - name: filter description: "A comma-separated list of list of search filters according to the following template: \"column_name operator 'values_list' \". For example, the query \"computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' \" will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType ." required: false - name: groups_ids_to_exclude description: A comma-separated list of group IDs to exclude from the operation. isArray: true - name: computers_ids_to_exclude description: A comma-separated list of computer IDs to exclude from the operation. isArray: true - name: computers_ids_to_include description: A comma-separated list of computer IDs to include in the operation. isArray: true - name: inform_user description: Determines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: allow_postpone description: Determines whether to allow the user to postpone the operation. auto: PREDEFINED defaultValue: 'true' predefined: - 'true' - 'false' - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: interval description: The interval between each poll in seconds. Minimum value is `10`. defaultValue: '30' - name: timeout description: The timeout for the polling in seconds. defaultValue: '600' - name: job_id description: The job ID to fetch data for. Hidden argument. hidden: true polling: true outputs: - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.job_id description: The job ID of the remediation operation. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.id description: The remediation operation ID. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.status description: Describes possible states in which a push operation may be in regards to a specific device. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.status description: Push operation response status. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.output description: Push operation response output. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.ipAddress description: The client device's IPv4 address. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.name description: The client device's name. type: String - contextPath: HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.id description: The client device's unique ID. type: String type: python subtype: python3 dockerimage: demisto/python3:3.12.13.10116658 isfetch: false script: '' fromversion: 6.10.0 tests: - No tests (auto formatted)