Skip to content

Commit fad9bf1

Browse files
authored
Merge pull request #25813 from microsoftgraph/repo_sync_working_branch
Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftgraph/microsoft-graph-docs-contrib (branch main)
2 parents 137e167 + f984706 commit fad9bf1

13 files changed

+37
-99
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/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/simulation-update.md

Lines changed: 2 additions & 1 deletion
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
# Update simulation
@@ -46,7 +47,7 @@ PATCH /security/attackSimulation/simulations/{simulationId}
4647

4748
|Property|Type|Description|
4849
|:---|:---|:---|
49-
|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).|
50+
|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).|
5051
|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`.|
5152
|displayName|String|Display name of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
5253
|durationInDays|Int32|Simulation duration in days.|

api-reference/beta/includes/snippets/powershell/create-simulations-powershell-snippets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,4 +45,4 @@ endUserNotificationSetting = @{
4545
4646
New-MgBetaSecurityAttackSimulation -BodyParameter $params
4747
48-
```
48+
```

api-reference/beta/resources/payload.md

Lines changed: 9 additions & 8 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: resourcePageType
8+
ms.date: 12/01/2024
89
---
910

1011
# payload resource type
@@ -34,7 +35,7 @@ Inherits from [entity](../resources/entity.md).
3435
|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the attack simulation and training campaign payload.|
3536
|createdDateTime|DateTimeOffset|Date and time when the attack simulation and training campaign payload. The timestamp represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
3637
|description|String|Description of the attack simulation and training campaign payload.|
37-
|detail|[payloadDetail](../resources/payloaddetail.md)|Additional details about the payload.|
38+
|detail|[payloadDetail](../resources/payloaddetail.md)|More details about the payload.|
3839
|displayName|String|Display name of the attack simulation and training campaign payload. Supports `$filter` and `$orderby`.|
3940
|id|String|Unique identifier for the attack simulation and training campaign payload. Inherited from [entity](../resources/entity.md).|
4041
|industry|[payloadIndustry](#payloadindustry-values)|Industry of a payload. Possible values are: `unknown`, `other`, `banking`, `businessServices`, `consumerServices`, `education`, `energy`, `construction`, `consulting`, `financialServices`, `government`, `hospitality`, `insurance`, `legal`, `courierServices`, `IT`, `healthcare`, `manufacturing`, `retail`, `telecom`, `realEstate`, `unknownFutureValue`.|
@@ -50,14 +51,14 @@ Inherits from [entity](../resources/entity.md).
5051
|simulationAttackType|[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`.|
5152
|source|[simulationContentSource](../resources/simulation.md#simulationcontentsource-values)|Simulation content source. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `global`, `tenant`, `unknownFutureValue`.|
5253
|status|[simulationContentStatus](../resources/simulation.md#simulationcontentstatus-values)|Simulation content status. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `draft`, `ready`, `archive`, `delete`, `unknownFutureValue`.|
53-
|technique|[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 on 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).|
54+
|technique|[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 on 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).|
5455
|theme|[payloadTheme](#payloadtheme-values)|The theme of a payload. Possible values are: `unknown`, `other`, `accountActivation`, `accountVerification`, `billing`, `cleanUpMail`, `controversial`, `documentReceived`, `expense`, `fax`, `financeReport`, `incomingMessages`, `invoice`, `itemReceived`, `loginAlert`, `mailReceived`, `password`, `payment`, `payroll`, `personalizedOffer`, `quarantine`, `remoteWork`, `reviewMessage`, `securityUpdate`, `serviceSuspended`, `signatureRequired`, `upgradeMailboxStorage`, `verifyMailbox`, `voicemail`, `advertisement`, `employeeEngagement`, `unknownFutureValue`.|
5556

5657
### payloadTheme values
5758

5859
|Member|Description |
5960
|:---|:---|
60-
|unknown| The payload theme is not defined. |
61+
|unknown| The payload theme isn't defined. |
6162
|other| The payload is other.|
6263
|accountActivation| Payload theme is of account activation.|
6364
|accountVerification| Payload theme is of account verification.|
@@ -88,7 +89,7 @@ Inherits from [entity](../resources/entity.md).
8889
|voicemail| Payload with voicemail details.|
8990
|advertisement| Payload with advertisement details.|
9091
|employeeEngagement| Payload with employee engagement details.|
91-
|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. |
92+
|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. |
9293

9394
### payloadBrand values
9495

@@ -114,7 +115,7 @@ Inherits from [entity](../resources/entity.md).
114115
|adobe| Payload brand as Adobe.|
115116
|teams| Payload brand as Teams.|
116117
|zoom| Payload brand as Zoom.|
117-
|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. |
118+
|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. |
118119

119120
### payloadIndustry values
120121

@@ -141,17 +142,17 @@ Inherits from [entity](../resources/entity.md).
141142
|retail| Payload industry as retail.|
142143
|telecom| Payload industry as telecom.|
143144
|realEstate| Payload industry as real estate.|
144-
|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. |
145+
|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. |
145146

146147
### payloadComplexity values
147148

148149
|Member|Description |
149150
|:---|:---|
150-
|unknown| The payload complexity is not defined. |
151+
|unknown| The payload complexity isn't defined. |
151152
|low| The payload complexity is low. |
152153
|medium| The payload complexity is medium. |
153154
|high| The payload complexity is high. |
154-
|unknownFutureValue| Evolvable enumeration sentinel value. Do not use. |
155+
|unknownFutureValue| Evolvable enumeration sentinel value. Don't use. |
155156

156157
## Relationships
157158

api-reference/beta/resources/profile.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: "profile resource type"
3-
description: "Represents properties that are descriptive of a user and that are surfaced in shared, people experiences across Microsoft 365 and third-party services and experiences via Microsoft Graph."
3+
description: "Represents properties that are descriptive of a user and that are surfaced in shared people experiences across Microsoft 365 and third-party services and experiences via Microsoft Graph."
44
ms.localizationpriority: medium
55
author: "kevinbellinger"
66
ms.subservice: people
77
doc_type: "resourcePageType"
8-
ms.date: 07/22/2024
8+
ms.date: 12/02/2024
99
---
1010

1111
# profile resource type
@@ -14,9 +14,11 @@ Namespace: microsoft.graph
1414

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

17-
Represents properties that are descriptive of a user in a tenant, for example, anniversaries and education activities. These properties are surfaced in shared, people experiences across Microsoft 365 and third-party services and experiences via Microsoft Graph.
17+
Represents properties that are descriptive of a user in a tenant; for example, anniversaries and education activities. These properties are surfaced in shared people experiences across Microsoft 365 and third-party services and experiences via Microsoft Graph.
1818

19-
Programmatically, these properties are expressed as [relationships](#relationships) of the **profile** resource. To get one of these navigation properties or create an instance of these properties for the user, use the corresponding GET or POST method on that property, where applicable. See the [methods](#methods) listed below.
19+
Programmatically, these properties are expressed as [relationships](#relationships) of the **profile** resource. To get one of these navigation properties or create an instance of these properties for the user, use the corresponding GET or POST method on that property, where applicable. For more details, see the [Methods](#methods) section.
20+
21+
In addition to the navigation properties in the [Relationships](#relationships) section, other properties exclusive to first-party applications, such as user pronouns, aren't exposed on Microsoft Graph.
2022

2123
## Methods
2224

0 commit comments

Comments
 (0)