Merge pull request #50171 from lootle1/MR96

JillGrant615 · web-flow · commit 7f80a5b4ea8f · 2025-04-29T09:31:13.000-06:00
Technical Review 1044110: Intro to Azure Policy
diff --git a/learn-pr/azure/intro-to-azure-policy/1-introduction.yml b/learn-pr/azure/intro-to-azure-policy/1-introduction.yml
@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.introduction
-title: Introduction
-metadata:
-  unitType: introduction
-  title: Introduction
-  description: "Introduction to Azure Policy."
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.introduction
+title: Introduction
+metadata:
+  unitType: introduction
+  title: Introduction
+  description: "Introduction to Azure Policy."
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/1-introduction.md)]
+
diff --git a/learn-pr/azure/intro-to-azure-policy/2-what-is-azure-policy.yml b/learn-pr/azure/intro-to-azure-policy/2-what-is-azure-policy.yml
@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.what-is-azure-policy
-title: What is Azure Policy?
-metadata:
-  unitType: learning-content
-  title: What is Azure Policy?
-  description: "What is Azure Policy and what can it be used for?"
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/2-what-is-azure-policy.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.what-is-azure-policy
+title: What is Azure Policy?
+metadata:
+  unitType: learning-content
+  title: What is Azure Policy?
+  description: "What is Azure Policy and what can it be used for?"
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/2-what-is-azure-policy.md)]
+
diff --git a/learn-pr/azure/intro-to-azure-policy/3-how-azure-policy-works.yml b/learn-pr/azure/intro-to-azure-policy/3-how-azure-policy-works.yml
@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.how-azure-policy-works
-title: How Azure Policy works
-metadata:
-  unitType: learning-content
-  title: How Azure Policy works
-  description: "Learn how to use Azure Policy to apply compliance and control in your environment."
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/3-how-azure-policy-works.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.how-azure-policy-works
+title: How Azure Policy works
+metadata:
+  unitType: learning-content
+  title: How Azure Policy works
+  description: "Learn how to use Azure Policy to apply compliance and control in your environment."
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/3-how-azure-policy-works.md)]
+
diff --git a/learn-pr/azure/intro-to-azure-policy/4-when-to-use-azure-policy.yml b/learn-pr/azure/intro-to-azure-policy/4-when-to-use-azure-policy.yml
@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.when-to-use-azure-policy
-title: When to use Azure Policy
-metadata:
-  unitType: learning-content
-  title: When to use Azure Policy
-  description: "Learn ways that you can use Azure Policy to manage resources."
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/4-when-to-use-azure-policy.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.when-to-use-azure-policy
+title: When to use Azure Policy
+metadata:
+  unitType: learning-content
+  title: When to use Azure Policy
+  description: "Learn ways that you can use Azure Policy to manage resources."
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/4-when-to-use-azure-policy.md)]
+
diff --git a/learn-pr/azure/intro-to-azure-policy/5-knowledge-check.yml b/learn-pr/azure/intro-to-azure-policy/5-knowledge-check.yml
@@ -1,49 +1,49 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.knowledge-check
-title: Module assessment
-metadata:
-  unitType: knowledge_check
-  title: Module assessment
-  description: "Check your knowledge about Azure Policy."
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 5
-content: |
-quiz:
-  questions:
-  - content: "Which of the following statements accurately describes Azure Policy?"
-    choices:
-    - content: "It's a service to create Group Policy objects on Azure."
-      isCorrect: false
-      explanation: "Incorrect. Azure Policy can't be used to create Group Policy objects."
-    - content: "It's a service for creating, assigning, and managing policies."
-      isCorrect: true
-      explanation: "Correct. This statement best describes Azure Policy."
-    - content: "It's a tool to enforce security controls."
-      isCorrect: false
-      explanation: "Incorrect. Azure Policy can help with policies to cover security controls, but isn't limited to that."
-  - content: "Is the following statement accurate? When you're using Azure Policy, you're restricted to Azure resources only."
-    choices:
-    - content: "This statement is wrong. You can use Azure Policy outside Azure."
-      isCorrect: true
-      explanation: "Azure Policy can handle Azure Arc enabled resources. That means you can extend the coverage of your controls over physical servers and virtual machines hosted outside Azure."
-    - content: "The statement is right. You're restricted to Azure resources when you work with Azure Policy."
-      isCorrect: false
-      explanation: "Incorrect. You can extend the coverage of Azure Policy to Azure Arc enabled resources outside Azure."
-    - content: "The statement is wrong. If you install the Azure Policy agent, you can work with resources hosted outside Azure."
-      isCorrect: false
-      explanation: "Incorrect. There's no Azure Policy agent."
-  - content: "Azure Policy is capable of:"
-    choices:
-    - content: "Monitoring the health of your virtual machines."
-      isCorrect: false
-      explanation: "Incorrect. Azure Policy isn't a monitoring tool."
-    - content: "Providing recommendations for your Azure resources."
-      isCorrect: false
-      explanation: "Incorrect. Azure Policy doesn't provide recommendations for your Azure resources. You can use Azure Advisor to get recommendations."
-    - content: "Adding required configuration at scale."
-      isCorrect: true
-      explanation: "Correct. As example, you can create a policy to enable Azure Backup for all virtual machines within an Azure subscription."
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.knowledge-check
+title: Module assessment
+metadata:
+  unitType: knowledge_check
+  title: Module assessment
+  description: "Check your knowledge about Azure Policy."
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 5
+content: |
+quiz:
+  questions:
+  - content: "Which of the following statements accurately describes Azure Policy?"
+    choices:
+    - content: "It's a service to create Group Policy objects on Azure."
+      isCorrect: false
+      explanation: "Incorrect. Azure Policy can't be used to create Group Policy objects."
+    - content: "It's a service for creating, assigning, and managing policies."
+      isCorrect: true
+      explanation: "Correct. This statement best describes Azure Policy."
+    - content: "It's a tool to enforce security controls."
+      isCorrect: false
+      explanation: "Incorrect. Azure Policy can help with policies to cover security controls but isn't limited to that."
+  - content: "Is the following statement accurate? When you're using Azure Policy, you're restricted to Azure resources only."
+    choices:
+    - content: "This statement is wrong. You can use Azure Policy outside Azure."
+      isCorrect: true
+      explanation: "Azure Policy can handle Azure Arc enabled resources. That means you can extend the coverage of your controls over physical servers and virtual machines hosted outside Azure."
+    - content: "The statement is right. You're restricted to Azure resources when you work with Azure Policy."
+      isCorrect: false
+      explanation: "Incorrect. You can extend the coverage of Azure Policy to Azure Arc enabled resources outside Azure."
+    - content: "The statement is wrong. If you install the Azure Policy agent, you can work with resources hosted outside Azure."
+      isCorrect: false
+      explanation: "Incorrect. There's no Azure Policy agent."
+  - content: "Azure Policy is capable of:"
+    choices:
+    - content: "Monitoring the health of your virtual machines."
+      isCorrect: false
+      explanation: "Incorrect. Azure Policy isn't a monitoring tool."
+    - content: "Providing recommendations for your Azure resources."
+      isCorrect: false
+      explanation: "Incorrect. Azure Policy doesn't provide recommendations for your Azure resources. You can use Azure Advisor to get recommendations."
+    - content: "Adding required configuration at scale."
+      isCorrect: true
+      explanation: "Correct. As an example, you can create a policy to enable Azure Backup for all virtual machines within an Azure subscription."
+
diff --git a/learn-pr/azure/intro-to-azure-policy/6-summary.yml b/learn-pr/azure/intro-to-azure-policy/6-summary.yml
@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.intro-to-azure-policy.summary
-title: Summary
-metadata:
-  unitType: summary
-  title: Summary
-  description: "Summary of Azure Policy and other reading."
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/6-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.intro-to-azure-policy.summary
+title: Summary
+metadata:
+  unitType: summary
+  title: Summary
+  description: "Summary of Azure Policy and other reading."
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/6-summary.md)]
+
diff --git a/learn-pr/azure/intro-to-azure-policy/includes/2-what-is-azure-policy.md b/learn-pr/azure/intro-to-azure-policy/includes/2-what-is-azure-policy.md
@@ -6,7 +6,7 @@ In summary, you use Azure Policy to:
   - Use built-in policies or build custom policies for all resource types.
   - Perform real-time policy evaluation and enforcement.
   - Perform periodic and on-demand compliance evaluation.
-- Apply policies at scale
+- Apply policies at scale:
   - Apply policies to a Management Group with control across your entire organization.
   - Apply multiple policies and aggregate policy states with policy initiatives.
   - Handle exclusion scopes.
diff --git a/learn-pr/azure/intro-to-azure-policy/includes/3-how-azure-policy-works.md b/learn-pr/azure/intro-to-azure-policy/includes/3-how-azure-policy-works.md
@@ -8,7 +8,7 @@ Here, we cover some concepts you need to understand in advance to work with Azur
 
 **Definitions:** The definitions are the list of built-in or custom initiatives and policies available to be assigned.
 
-**Assignments:** The assignments are the associations of initiatives or policies with scopes. A scope for Azure Policy could be a Management Group, an Azure Subscription or a Resource Group. All child resources inherit the assignments of the parent resource.
+**Assignments:** The assignments are the associations of initiatives or policies with scopes. A scope for Azure Policy could be a Management Group, an Azure Subscription, or a Resource Group. All child resources inherit the assignments of the parent resource.
 
 **Exemptions:**: The exemptions are used to exempt a resource hierarchically or an individual resource from the evaluation of initiatives or definitions.
 
@@ -18,7 +18,7 @@ Here, we cover some concepts you need to understand in advance to work with Azur
 
 ## Resources covered
 
-Azure policy covers all Azure resources, including Arc-enabled resources. For example, you can extend the coverage of your controls over Windows and Linux physical servers, and virtual machines hosted outside of Azure, on your corporate network, or other cloud providers. Using Azure Policy is free for Azure resources, but there's a fee associated for an Arc resource.
+Azure policy covers all Azure resources, including Arc-enabled resources. For example, you can extend the coverage of your controls over Windows and Linux physical servers, and virtual machines hosted outside of Azure, on your corporate network or other cloud providers. Using Azure Policy is free for Azure resources, but there's a fee associated for an Arc resource.
 
 Azure Arc is a service that allows you to manage resource types hosted outside of Azure. The following resource types are supported:
 
@@ -27,7 +27,7 @@ Azure Arc is a service that allows you to manage resource types hosted outside o
 - Azure data services such as Azure SQL Managed Instance.
 - SQL Server.
 
-You can also provision, resize, delete and manage virtual machines based on VMware vSphere or Azure Stack HCI and enable VM self-service through role-based access.
+You can also provision, resize, delete, and manage virtual machines based on VMware vSphere or Azure Stack HCI. You can enable VM self-service through role-based access.
 
 ## Related services
 
diff --git a/learn-pr/azure/intro-to-azure-policy/includes/6-summary.md b/learn-pr/azure/intro-to-azure-policy/includes/6-summary.md
@@ -8,8 +8,8 @@ To learn more, review the following articles:
 
 - [What is Azure Policy?](/azure/governance/policy/overview)
 - [Policy version (preview)](/azure/governance/policy/concepts/definition-structure-basics#version-preview)
-- [Assign a policy](/azure/governance/policy/assign-policy-portal)
+- [Create a policy assignment](/azure/governance/policy/assign-policy-portal)
 - [Azure Policy samples](/azure/governance/policy/samples)
 - [Azure Resource Graph sample queries for Azure Policy](/azure/governance/policy/samples/resource-graph-samples)
-- [Recommended policies for Azure virtual machines](/azure/governance/policy/concepts/recommended-policies)
+- [Azure virtual machine recommended policies](/azure/governance/policy/concepts/recommended-policies)
 - [Azure security baseline for Azure Policy](/security/benchmark/azure/baselines/policy-security-baseline)
diff --git a/learn-pr/azure/intro-to-azure-policy/index.yml b/learn-pr/azure/intro-to-azure-policy/index.yml
@@ -1,43 +1,43 @@
-### YamlMime:Module
-uid: learn.intro-to-azure-policy
-metadata:
-  moduleType: introduction
-  title: Introduction to Azure Policy
-  description: "This module introduces you to Azure Policy and describes how to use it to meet compliance requirements in your environment."
-  manager: jasongroce
-  ms.date: 07/19/2024
-  author: ricmmartins
-  ms.author: ricardomac
-  ms.topic: module-standard-task-based
-  ms.service: azure-policy
-title: Intro to Azure Policy
-summary: "This module introduces you to Azure Policy and describes its characteristics, capabilities, and use cases."
-abstract: |
-  By the end of this module, you're able to:
-    - Describe how features of Azure Policy can help you apply compliance, apply control, and add required configuration at scale.
-prerequisites: |
-  - Basic knowledge of the Azure portal
-  - Basic knowledge of Azure resources
-iconUrl: /training/achievements/generic-badge.svg
-levels:
-  - beginner
-roles:
-  - developer
-  - administrator
-  - solution-architect
-  - technology-manager
-products:
-- azure
-- azure-policy
-subjects:
-- cloud-security
-units:
-- learn.intro-to-azure-policy.introduction
-- learn.intro-to-azure-policy.what-is-azure-policy
-- learn.intro-to-azure-policy.how-azure-policy-works
-- learn.intro-to-azure-policy.when-to-use-azure-policy
-- learn.intro-to-azure-policy.knowledge-check
-- learn.intro-to-azure-policy.summary
-badge:
-  uid: learn.intro-to-azure-policy.badge
-
+### YamlMime:Module
+uid: learn.intro-to-azure-policy
+metadata:
+  moduleType: introduction
+  title: Introduction to Azure Policy
+  description: "This module introduces you to Azure Policy and describes how to use it to meet compliance requirements in your environment."
+  manager: jasongroce
+  ms.date: 04/28/2025
+  author: ricmmartins
+  ms.author: ricardomac
+  ms.topic: module-standard-task-based
+  ms.service: azure-policy
+title: Intro to Azure Policy
+summary: "This module introduces you to Azure Policy and describes its characteristics, capabilities, and use cases."
+abstract: |
+  By the end of this module, you're able to:
+    - Describe how features of Azure Policy can help you apply compliance, apply control, and add required configuration at scale.
+prerequisites: |
+  - Basic knowledge of the Azure portal
+  - Basic knowledge of Azure resources
+iconUrl: /training/achievements/generic-badge.svg
+levels:
+  - beginner
+roles:
+  - developer
+  - administrator
+  - solution-architect
+  - technology-manager
+products:
+- azure
+- azure-policy
+subjects:
+- cloud-security
+units:
+- learn.intro-to-azure-policy.introduction
+- learn.intro-to-azure-policy.what-is-azure-policy
+- learn.intro-to-azure-policy.how-azure-policy-works
+- learn.intro-to-azure-policy.when-to-use-azure-policy
+- learn.intro-to-azure-policy.knowledge-check
+- learn.intro-to-azure-policy.summary
+badge:
+  uid: learn.intro-to-azure-policy.badge
+
