Skip to content

Latest commit

 

History

History
191 lines (153 loc) · 7.42 KB

threatassessment-get.md

File metadata and controls

191 lines (153 loc) · 7.42 KB
Raw

purview threatassessment get

Get a threat assessment

Usage

m365 purview threatassessment get [options]

Options

-i, --id <id> : The Id of the threat assessment

--includeResults : Include the threat assessment results

--8<-- "docs/cmd/_global.md"

Examples

Get a threat assessment

m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e

Get a threat assessment including results

m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults

Response

Standard Response

=== "JSON"

```json
{
  "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
  "createdDateTime": "2023-02-25T00:23:33.0550644Z",
  "contentType": "mail",
  "expectedAssessment": "block",
  "category": "spam",
  "status": "pending",
  "requestSource": "administrator",
  "recipientEmail": "john@contoso.com",
  "destinationRoutingReason": "notJunk",
  "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
  "createdBy": {
    "user": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "John Doe"
    }
  }
}
```

=== "Text"

```text
category                : spam
contentType             : mail
createdBy               : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
createdDateTime         : 2023-02-25T00:23:33.0550644Z
destinationRoutingReason: notJunk
expectedAssessment      : block
id                      : 8aaba0ac-ec4d-4e62-5774-08db16c68731
messageUri              : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
recipientEmail          : john@contoso.com
requestSource           : administrator
status                  : pending
```

=== "CSV"

```csv
id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy
8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}"
```

=== "Markdown"

```md
# purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731"

Date: 25/02/2023

## 8aaba0ac-ec4d-4e62-5774-08db16c68731

Property | Value
---------|-------
id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
createdDateTime | 2023-02-25T00:23:33.0550644Z
contentType | mail
expectedAssessment | block
category | spam
status | pending
requestSource | administrator
recipientEmail | john@contoso.com
destinationRoutingReason | notJunk
messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
```

includeResults response

When we make use of the option includeResults the response will differ.

=== "JSON"

```json
{
  "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
  "createdDateTime": "2023-02-25T00:23:33.0550644Z",
  "contentType": "mail",
  "expectedAssessment": "block",
  "category": "spam",
  "status": "pending",
  "requestSource": "administrator",
  "recipientEmail": "john@contoso.com",
  "destinationRoutingReason": "notJunk",
  "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
  "createdBy": {
    "user": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "John Doe"
    }
  },
  "results": [
    {
      "id": "a5455871-18d1-44d8-0866-08db16c68b85",
      "createdDateTime": "2023-02-25T00:23:40.28Z",
      "resultType": "checkPolicy",
      "message": "No policy was hit."
    }
  ]
}
```

=== "Text"

```text
category                : spam
contentType             : mail
createdBy               : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
createdDateTime         : 2023-02-25T00:23:33.0550644Z
destinationRoutingReason: notJunk
expectedAssessment      : block
id                      : 8aaba0ac-ec4d-4e62-5774-08db16c68731
messageUri              : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
recipientEmail          : john@contoso.com
requestSource           : administrator
results                 : [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
status                  : pending
```

=== "CSV"

```csv
id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy,results
8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}","[{""id"":""a5455871-18d1-44d8-0866-08db16c68b85"",""createdDateTime"":""2023-02-25T00:23:40.28Z"",""resultType"":""checkPolicy"",""message"":""No policy was hit.""}]"
```

=== "Markdown"

```md
# purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"

Date: 25/02/2023

## 8aaba0ac-ec4d-4e62-5774-08db16c68731

Property | Value
---------|-------
id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
createdDateTime | 2023-02-25T00:23:33.0550644Z
contentType | mail
expectedAssessment | block
category | spam
status | pending
requestSource | administrator
recipientEmail | john@contoso.com
destinationRoutingReason | notJunk
messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
results | [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
```