Skip to content

Commit 121fa6b

Browse files
LauragraLauragra
authored
Merge pull request #25814 from microsoftgraph/main
Merge to publish.
2 parents fba8365 + 3b59e7b commit 121fa6b

File tree

135 files changed

+3372
-382
lines changed

Some content is hidden

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

135 files changed

+3372
-382
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/bitlocker-list-recoverykeys.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: "myra-ramdenbourg"
55
ms.localizationpriority: medium
66
ms.subservice: "entra-directory-management"
77
doc_type: apiPageType
8+
ms.date: 11/29/2024
89
---
910

1011
# List recoveryKeys
@@ -16,6 +17,8 @@ Get a list of the [bitlockerRecoveryKey](../resources/bitlockerrecoverykey.md) o
1617

1718
This operation does not return the **key** property. For information about how to read the **key** property, see [Get bitlockerRecoveryKey](bitlockerrecoverykey-get.md).
1819

20+
You can use this API to programmatically iterate through the list of recovery keys in the tenant and identify devices with BitLocker enabled. For more information, see the sample PowerShell code in [BitLocker recovery process](/windows/security/operating-system-security/data-protection/bitlocker/recovery-process#helpdesk-recovery-in-microsoft-entra-id).
21+
1922
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2023

2124
## Permissions

‎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/group-assignlicense.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Add or remove licenses on the group. Licenses assigned to the group will be assigned to all users in the group. Group-based licensing is an alternative to [direct user licensing](../api/user-assignlicense.md). To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal).
17+
Add or remove licenses on a [group](../resources/group.md). Licenses assigned to the group will be assigned to all users in the group. Group-based licensing is an alternative to [direct user licensing](../api/user-assignlicense.md). To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal).
1818

1919
To get the subscriptions available in the directory, perform a [GET subscribedSkus request](subscribedsku-list.md).
2020

‎api-reference/beta/api/group-delete-approleassignments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Namespace: microsoft.graph
1313

1414
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1515

16-
Deletes an [appRoleAssignment](../resources/approleassignment.md) that a group has been granted.
16+
Delete an [appRoleAssignment](../resources/approleassignment.md) that a [group](../resources/group.md) has been granted.
1717

1818
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
1919

‎api-reference/beta/api/group-delete-members.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Remove a member from a group via the **members** navigation property. You can't remove a member from groups with dynamic memberships.
17+
Remove a member from a [group](../resources/group.md) via the **members** navigation property. You can't remove a member from groups with dynamic memberships.
1818

1919
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

‎api-reference/beta/api/group-delete-owners.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Remove group owner"
3-
description: "Use this API to remove an owner from a Microsoft 365 group or a security group through the owners navigation property."
3+
description: "Remove an owner from a Microsoft 365 group or a security group through the owners navigation property."
44
ms.localizationpriority: medium
55
author: "yuhko-msft"
66
ms.reviewer: "mbhargav, khotzteam, aadgroupssg"
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Use this API to remove an owner from a Microsoft 365 group or a security group through the **owners** navigation property. When owners are assigned to a group, the last owner (a user object) of the group cannot be removed.
17+
Remove an owner from a Microsoft 365 [group](../resources/group.md) or a security group through the **owners** navigation property. When owners are assigned to a group, the last owner (a user object) of the group cannot be removed.
1818

1919
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

0 commit comments

Comments
 (0)