Run Compliance Search Action

Run an action on the results of a completed compliance search. Use the Get Compliance Search Action using the JobRunId or Name to view the results of the action.

For more information, view the Microsoft Documentation.

note

The compliance search must completed in order to perform an action on it.

info

The action may succeed with "No Output" if the permissions are invalid, but the parameters are correct.

Verify that the action returns a output and that requested operation was actually performed.

Installed version: 3.5.0

Basic Parameters

Parameter	Description
Purge Type	How to remove purged items. SoftDelete: Purged items are recoverable by users until the deleted item retention period expires. HardDelete (cloud only): Purged items are marked for permanent removal from the mailbox and will be permanently removed the next time the mailbox is processed by the Managed Folder Assistant. If single item recovery is enabled on the mailbox, purged items will be permanently removed after the deleted item retention period expires.
Search Name	Name or Job ID of the compliance search to attach the action to.
Type	The type of the action.

Advanced Parameters

Parameter	Description
Include Credentials	Whether to include the credentials needed to view the results.

Example Output

{
    "PSComputerName": "eur05b.ps.compliance.protection.outlook.com",
    "RunspaceId": "4bc31fa8-61f9-449f-8617-4672f21c636b",
    "PSShowComputerName": false,
    "SearchName": "my-search",
    "EstimateSearchRunId": "7a8a71ea-18b9-4cfd-5449-08db22e9e7e0",
    "EstimateSearchJobId": "c2c1e1b8-0594-4108-4ef3-08db22e9a13d",
    "ActionVersion": "",
    "Results": "{}",
    "Errors": "",
    "Action": "Preview",
    "ValidDuration": {
        "Ticks": 1728000000000,
        "Days": 2,
        "Hours": 0,
        "Milliseconds": 0,
        "Microseconds": 0,
        "Nanoseconds": 0,
        "Minutes": 0,
        "Seconds": 0,
        "TotalDays": 2,
        "TotalHours": 48,
        "TotalMilliseconds": 172800000,
        "TotalMicroseconds": 172800000000,
        "TotalNanoseconds": 172800000000000,
        "TotalMinutes": 2880,
        "TotalSeconds": 172800
    },
    "JobId": "84d17827-e8cd-4588-ffc0-08db22ea0fbb",
    "Name": "my-search",
    "CreatedTime": "2023-03-12T11:08:08.473",
    "LastModifiedTime": "2023-03-12T11:08:08.473",
    "JobStartTime": "2023-03-12T11:08:08.55",
    "JobEndTime": null,
    "Description": "",
    "CreatedBy": "John Doe",
    "RunBy": "John Doe",
    "TenantId": "b903ec40-8a55-469a-81bf-2f6a26736618",
    "NumBindings": 0,
    "Status": "Starting",
    "ExchangeLocation": [
        "john.doe@test.onmicrosoft.com"
    ],
    "PublicFolderLocation": null,
    "SharePointLocation": null,
    "OneDriveLocation": null,
    "ExchangeLocationExclusion": null,
    "PublicFolderLocationExclusion": null,
    "SharePointLocationExclusion": null,
    "OneDriveLocationExclusion": null,
    "JobRunId": "284dda5c-1d78-493f-eb46-08db22ea0fc7",
    "Retry": false,
    "AllowNotFoundExchangeLocationsEnabled": false,
    "JobOptions": 272,
    "JobProgress": 0,
    "CaseId": null,
    "CaseName": "",
    "PagingState": "",
    "Identity": "284dda5c-1d78-493f-eb46-08db22ea0fc7",
    "ContentURL": "",
    "ResultInEOP": false,
    "AzureBatchFrameworkEnabled": true,
    "IsValid": true,
    "ObjectState": "New"
}

Automation Library Example

Run Compliance Search Action with Exchange Online and Send Results Via Slack

Preview this Automation on desktop