Skip to content

Commit a34b81b

Browse files
satpatel1satpatel1
authored
Merge branch 'main' into user/satpatel/docChangesRS
2 parents a7495d8 + 3b59e7b commit a34b81b

File tree

78 files changed

+3272
-308
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

78 files changed

+3272
-308
lines changed

‎api-reference/beta/api/attacksimulationroot-post-simulation.md

Lines changed: 3 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: "stuartcl"
55
ms.localizationpriority: medium
66
ms.subservice: "security"
77
doc_type: apiPageType
8+
ms.date: 12/01/2024
89
---
910

1011
# Create simulation
@@ -49,7 +50,7 @@ The following table lists the properties that are required when you create the s
4950

5051
| Property | Type | Description |
5152
|:-------------|:------------|:------------|
52-
|attackTechnique|[simulationAttackTechnique](../resources/simulation.md#simulationattacktechnique-values)|The social engineering technique used in the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `credentialHarvesting`, `attachmentMalware`, `driveByUrl`, `linkInAttachment`, `linkToMalwareFile`, `unknownFutureValue`, `oAuthConsentGrant`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `oAuthConsentGrant`. For more information about the types of social engineering attack techniques, see [simulations](/microsoft-365/security/office-365-security/attack-simulation-training-get-started?view=o365-worldwide&preserve-view=true#simulations).|
53+
|attackTechnique|[simulationAttackTechnique](../resources/simulation.md#simulationattacktechnique-values)|The social engineering technique used in the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `credentialHarvesting`, `attachmentMalware`, `driveByUrl`, `linkInAttachment`, `linkToMalwareFile`, `unknownFutureValue`, `oAuthConsentGrant`, `phishTraining`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `oAuthConsentGrant`, `phishTraining`. For more information about the types of social engineering attack techniques, see [simulations](/microsoft-365/security/office-365-security/attack-simulation-training-get-started?view=o365-worldwide&preserve-view=true#simulations).|
5354
|attackType|[simulationAttackType](../resources/simulation.md#simulationattacktype-values)|Attack type of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `social`, `cloud`, `endpoint`, `unknownFutureValue`.|
5455
|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the attack simulation and training campaign.|
5556
|displayName|String|Display name of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
@@ -76,7 +77,6 @@ If successful, this method returns a `202 Accepted` response code and a tracking
7677

7778
The following example shows a request.
7879

79-
# [HTTP](#tab/http)
8080
<!-- {
8181
"blockType": "request",
8282
"name": "create_simulations"
@@ -113,7 +113,7 @@ Content-type: application/json
113113
"settingType": "noTraining",
114114
"positiveReinforcement": {
115115
"deliveryPreference": "deliverAfterCampaignEnd",
116-
"endUserNotification": "https://graph.microsoft.com/beta/security/attacksimulation/endUserNotifications/1ewer3678-9abc-def0-123456789a",
116+
"endUserNotification@odata.bind": "https://graph.microsoft.com/beta/security/attacksimulation/endUserNotifications/1ewer3678-9abc-def0-123456789a",
117117
"defaultLanguage": "en"
118118
},
119119
"simulationNotification": {
@@ -125,40 +125,6 @@ Content-type: application/json
125125
}
126126
```
127127

128-
# [C#](#tab/csharp)
129-
[!INCLUDE [sample-code](../includes/snippets/csharp/create-simulations-csharp-snippets.md)]
130-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
131-
132-
# [CLI](#tab/cli)
133-
[!INCLUDE [sample-code](../includes/snippets/cli/create-simulations-cli-snippets.md)]
134-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
135-
136-
# [Go](#tab/go)
137-
[!INCLUDE [sample-code](../includes/snippets/go/create-simulations-go-snippets.md)]
138-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
139-
140-
# [Java](#tab/java)
141-
[!INCLUDE [sample-code](../includes/snippets/java/create-simulations-java-snippets.md)]
142-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
143-
144-
# [JavaScript](#tab/javascript)
145-
[!INCLUDE [sample-code](../includes/snippets/javascript/create-simulations-javascript-snippets.md)]
146-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
147-
148-
# [PHP](#tab/php)
149-
[!INCLUDE [sample-code](../includes/snippets/php/create-simulations-php-snippets.md)]
150-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
151-
152-
# [PowerShell](#tab/powershell)
153-
[!INCLUDE [sample-code](../includes/snippets/powershell/create-simulations-powershell-snippets.md)]
154-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
155-
156-
# [Python](#tab/python)
157-
[!INCLUDE [sample-code](../includes/snippets/python/create-simulations-python-snippets.md)]
158-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
159-
160-
---
161-
162128
### Response
163129

164130
The following example shows the response.

‎api-reference/beta/api/cloudpcreports-getcloudpcperformancereport.md

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
---
2+
title: "cloudPcReports: getCloudPCPerformanceReport"
3+
description: "Get a report related to the performance of Cloud PCs."
4+
author: "Gutentag0004"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-pc"
7+
doc_type: apiPageType
8+
ms.date: 11/30/2024
9+
---
10+
11+
# cloudPcReports: getCloudPCPerformanceReport
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a report related to the performance of Cloud PCs.
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- { "blockType": "permissions", "name": "cloudpcreports-getcloudpcperformancereport" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/cloudpcreports-getcloudpcperformancereport-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- {
29+
"blockType": "ignored"
30+
}
31+
-->
32+
``` http
33+
POST /deviceManagement/virtualEndpoint/reports/getCloudPCPerformanceReport
34+
```
35+
36+
## Request headers
37+
38+
|Name|Description|
39+
|:---|:---|
40+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
41+
|Content-Type|application/json. Required.|
42+
43+
## Request body
44+
45+
In the request body, supply a JSON representation of the parameters.
46+
47+
The following table shows the parameters that you can use with this method.
48+
49+
| Parameter | Type | Description |
50+
|:-----------|:-----------------------------|:-----------------------------------------------------------------------------------------------------|
51+
| filter | String | OData `$filter` syntax. Supported filters are: `and`, `or`, `gt`, and `eq`. |
52+
| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the **select** parameter. |
53+
| orderBy | String collection | Specifies how to sort the reports. |
54+
| reportName | cloudPCPerformanceReportName | The report name. The possible values are: `performanceTrendReport`, `unknownFutureValue`. |
55+
| search | String | Specifies a String to search. |
56+
| select | String collection | OData `$select` syntax. The selected columns of the reports. |
57+
| skip | Int32 | Number of records to skip. |
58+
| top | Int32 | Specifies the page size. If not defined, the default is 25, with a maximum of 100. |
59+
60+
### cloudPCPerformanceReportName values
61+
62+
| Member | Description |
63+
| :--------------------------- | :---------------- |
64+
| performanceTrendReport | Indicates a daily aggregated report that provides a list of connection quality metrics for Cloud PCs over the past seven days within a tenant. The metrics include `SlowRoundTripTimeCloudPcCount`, `LowUdpConnectionPercentageCount`, `NoTimeConnectedCloudPcCount`, and `LowTimeConnectedCloudPcCount`. Each daily report is an aggregation of the previous 28 days, counted back from the trigger time. |
65+
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
66+
67+
## Response
68+
69+
If successful, this method returns a `200 OK` response code and a Stream object in the response body.
70+
71+
## Examples
72+
73+
### Request
74+
75+
The following example shows a request.
76+
77+
<!-- {
78+
"blockType": "request",
79+
"name": "cloudpcreportsthis.getcloudpcperformancereport"
80+
}
81+
-->
82+
``` http
83+
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getCloudPcPerformanceReport
84+
Content-Type: application/json
85+
86+
{
87+
"reportName": "performanceTrendReport",
88+
"filter": "EventDateTime gt datetime'2023-10-13T00:00:00.000Z'",
89+
"select": [
90+
"EventDateTime",
91+
"SlowRoundTripTimeCloudPcCount",
92+
"LowUdpConnectionPercentageCount",
93+
"NoActiveTimeConnectedCount",
94+
"LowActiveTimeConnectedCount"
95+
],
96+
"search": "",
97+
"skip": 0,
98+
"top": 50
99+
}
100+
```
101+
102+
### Response
103+
104+
The following example shows the response.
105+
106+
>**Note:** The response object shown here might be shortened for readability.
107+
<!-- {
108+
"blockType": "response",
109+
"truncated": true,
110+
"@odata.type": "Edm.Stream"
111+
} -->
112+
``` http
113+
HTTP/1.1 200 OK
114+
Content-Type: application/octet-stream
115+
116+
{
117+
"TotalRowCount": 2,
118+
"Schema": [
119+
{
120+
"Column": "EventDateTime",
121+
"PropertyType": "DateTime"
122+
},
123+
{
124+
"Column": "SlowRoundTripTimeCloudPcCount",
125+
"PropertyType": "Int64"
126+
},
127+
{
128+
"Column": "LowUdpConnectionPercentageCount",
129+
"PropertyType": "Int64"
130+
},
131+
{
132+
"Column": "NoActiveTimeConnectedCount",
133+
"PropertyType": "Int64"
134+
},
135+
{
136+
"Column": "LowActiveTimeConnectedCount",
137+
"PropertyType": "Int64"
138+
}
139+
],
140+
"Values": [
141+
[
142+
"2023-10-16T00:00:00Z",
143+
3,
144+
8,
145+
3,
146+
92
147+
],
148+
[
149+
"2023-10-15T00:00:00Z",
150+
4,
151+
6,
152+
5,
153+
91
154+
]
155+
]
156+
}
157+
```
158+

‎api-reference/beta/api/cloudpcreports-getinaccessiblecloudpcreports.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,18 +46,27 @@ POST /deviceManagement/virtualEndpoint/reports/getInaccessibleCloudPcReports
4646

4747
In the request body, supply a JSON representation of the parameters.
4848

49-
The following table shows the parameters that can be used with this method.
49+
The following table shows the parameters that you can use with this method.
5050

5151
| Parameter | Type | Description |
5252
|:----------|:------------------|:-------------------------------------------------------------------------------------------|
5353
| filter | String | OData `$filter` syntax. Only `and`, `or`, `gt` ,`ge` and `eq` are currently supported. |
54-
| select | String collection | OData `$select` syntax. Represents the selected columns of the reports. |
55-
| search | String | Specifies a String to search for. |
5654
| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the select parameter.|
5755
| orderBy | String collection | Specifies how to sort the reports. |
56+
| reportName | cloudPCInaccessibleReportName | The report name. The possible values are: `inaccessibleCloudPcReports`, `inaccessibleCloudPcTrendReport`, `unknownFutureValue`. The default value is `inaccessibleCloudPcReports` if the **reportName** is empty. |
57+
| search | String | Specifies a String to search for. |
58+
| select | String collection | OData `$select` syntax. Represents the selected columns of the reports. |
5859
| skip | Int32 | Number of records to skip. |
5960
| top | Int32 | The number of top records to return. |
6061

62+
### cloudPCInaccessibleReportName values
63+
64+
| Member | Description |
65+
| :------------------------------ | :------------------------ |
66+
| inaccessibleCloudPcReports | Indicates a report that contains details of Cloud PCs that are inaccessible, including those with consecutive connection failures or in an unavailable state. |
67+
| inaccessibleCloudPcTrendReport| Indicates a daily aggregated report for a specified period that contains details of Cloud PCs that are inaccessible, including those with consecutive connection failures or in an unavailable state. |
68+
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
69+
6170
## Response
6271

6372
If successful, this method returns a `200 OK` response code and a Stream object in the response body.

‎api-reference/beta/api/cloudpcreports-post-exportjobs.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,8 @@ You can specify the following properties when you create a **cloudPcExportJob**.
4949
|Property|Type|Description|
5050
|:---|:---|:---|
5151
|filter|String|The filter applied on the report. Optional.|
52-
|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`.|
52+
|format|String|The format of the exported report. Optional.|
53+
|reportName|[cloudPcReportName](../resources/cloudpcexportjob.md#cloudpcreportname-values)|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`.|
5354
|select|String collection|The selected columns of the report. Optional.|
5455

5556
## Response

‎api-reference/beta/api/intune-shared-deviceappmanagement-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Namespace: microsoft.graph
1818
1919
Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
2020

21-
## Permissions
21+
## Permissions
2222

2323
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Note that the appropriate permission varies according to the workflow.
2424

‎api-reference/beta/api/payload-get.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: "stuartcl"
55
ms.localizationpriority: medium
66
ms.subservice: "security"
77
doc_type: apiPageType
8+
ms.date: 12/01/2024
89
---
910

1011
# Get payload
@@ -37,7 +38,7 @@ GET /security/attackSimulation/simulations/{simulationId}/payload
3738

3839
## Optional query parameters
3940

40-
This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.
41+
This method doesn't currently support the [OData query parameters](/graph/query-parameters) to customize the response.
4142

4243
## Request headers
4344

@@ -66,7 +67,7 @@ The following example shows a request.
6667
}
6768
-->
6869
``` http
69-
GET https://graph.microsoft.com/beta/security/attackSimulation/payload/f1b13829-3829-f1b1-2938-b1f12938b1a
70+
GET https://graph.microsoft.com/beta/security/attackSimulation/payloads/f1b13829-3829-f1b1-2938-b1f12938b1a
7071
```
7172

7273
### Response

‎api-reference/beta/api/payloaddetail-get.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: "stuartcl"
55
ms.localizationpriority: medium
66
ms.subservice: "security"
77
doc_type: apiPageType
8+
ms.date: 12/01/2024
89
---
910

1011
# Get payloadDetail
@@ -34,7 +35,7 @@ GET /security/attackSimulation/payloads/{payloadId}/detail
3435

3536
## Optional query parameters
3637

37-
This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.
38+
This method doesn't currently support the [OData query parameters](/graph/query-parameters) to customize the response.
3839

3940
## Request headers
4041

@@ -63,7 +64,7 @@ The following example shows a request.
6364
}
6465
-->
6566
``` http
66-
GET https://graph.microsoft.com/beta/security/attackSimulation/payload/f1b13829-3829-f1b1-2938-b1f12938b1a/detail
67+
GET https://graph.microsoft.com/beta/security/attackSimulation/payloads/f1b13829-3829-f1b1-2938-b1f12938b1a/detail
6768
```
6869

6970
### Response

‎api-reference/beta/api/security-ediscoverysearch-purgedata.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ Namespace: microsoft.graph.security
1515

1616
Delete Exchange mailbox items or Microsoft Teams messages contained in an [eDiscovery search](../resources/security-ediscoverysearch.md).
1717

18-
>**Note:** This request purges a maximum of 100 items per location only.
19-
2018
You can collect and purge the following categories of Teams content:
2119
- **Teams 1:1 chats** - Chat messages, posts, and attachments shared in a Teams conversation between two people. Teams 1:1 chats are also called *conversations*.
2220
- **Teams group chats** - Chat messages, posts, and attachments shared in a Teams conversation between three or more people. Also called *1:N* chats or *group conversations*.
2321
- **Teams channels** - Chat messages, posts, replies, and attachments shared in a standard Teams channel.
2422
- **Private channels** - Message posts, replies, and attachments shared in a private Teams channel.
2523
- **Shared channels** - Message posts, replies, and attachments shared in a shared Teams channel.
2624

25+
>**Note:** This request purges a maximum of 100 items per location only. When **purgeType** is set to either `recoverable` or `permanentlyDelete` and **purgeAreas** is set to `teamsMessages`, the Teams messages are permanently deleted.
26+
2727
For more information about purging Teams messages, see:
2828
- [eDiscovery solution series: Data spillage scenario - Search and purge](/microsoft-365/compliance/data-spillage-scenariosearch-and-purge)
2929
- [eDiscovery (Premium) workflow for content in Microsoft Teams](/microsoft-365/compliance/teams-workflow-in-advanced-ediscovery)

0 commit comments

Comments
 (0)