Skip to content

Commit bdf1118

Browse files
committed
Fixes MicrosoftDocs/azure-docs#40501 - Provide clarity around Disabled effect and enforcementMode
1 parent 28fe32f commit bdf1118

File tree

2 files changed

+10
-2
lines changed

2 files changed

+10
-2
lines changed

articles/governance/policy/concepts/assignment-structure.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,8 +58,11 @@ characters and **description** a maximum length of _512_ characters.
5858
## Enforcement Mode
5959

6060
The **enforcementMode** property provides customers the ability to test the outcome of a policy on
61-
existing resources without initiating the policy effect or triggering entries in the [Azure Activity log](../../../azure-monitor/platform/activity-logs-overview.md).
62-
This scenario is commonly referred to as "What If" and aligns to safe deployment practices.
61+
existing resources without initiating the policy effect or triggering entries in the
62+
[Azure Activity log](../../../azure-monitor/platform/activity-logs-overview.md). This scenario is
63+
commonly referred to as "What If" and aligns to safe deployment practices. **enforcementMode** is
64+
different from the [Disabled](./effects.md#disabled) effect, as that effect prevents resource
65+
evaluation from happening at all.
6366

6467
This property has the following values:
6568

articles/governance/policy/concepts/effects.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,11 @@ This effect is useful for testing situations or for when the policy definition h
5050
effect. This flexibility makes it possible to disable a single assignment instead of disabling all
5151
of that policy's assignments.
5252

53+
An alternative to the Disabled effect is **enforcementMode** which is set on the policy assignment.
54+
When **enforcementMode** is _Disabled_, resources are still evaluated. Logging, such as Activity
55+
logs, and the policy effect don't occur. For more information, see
56+
[policy assignment - enforcement mode](./assignment-structure.md#enforcement-mode).
57+
5358
## Append
5459

5560
Append is used to add additional fields to the requested resource during creation or update. A

0 commit comments

Comments
 (0)