Merge pull request #115102 from dominicbetts/hub-policy-samples

Add Azure Policy samples - IoT

Author: v-dihans

articles/iot-fundamentals/toc.yml

@@ -21,5 +21,4 @@
   - name: Security architecture
     href: iot-security-architecture.md
   - name: Secure deployment
-    href: iot-security-deployment.md 
-
+    href: iot-security-deployment.md

articles/iot-hub/TOC.yml

@@ -81,6 +81,11 @@
       href: tutorial-firmware-update.md
     - name: Test device connectivity
       href: tutorial-connectivity.md
+- name: Samples
+  items:
+  - name: Azure Policy built-ins
+    displayName: samples, policies, definitions
+    href: ./policy-samples.md
 - name: Concepts
   items:
     - name: TLS support

articles/iot-hub/policy-samples.md

@@ -0,0 +1,32 @@
+---
+title: Built-in policy definitions for Azure IoT Hub
+description: Lists Azure Policy built-in policy definitions for Azure IoT Hub. These built-in policy definitions provide common approaches to managing your Azure resources.
+ms.date: 05/05/2020
+ms.topic: sample
+author: robinsh
+ms.author: robinsh
+ms.service: iot-hub
+ms.custom: subject-policy-samples
+---
+
+# Azure Policy built-in policy definitions for Azure IoT Hub
+
+For IoT Hub sample code that shows how to implement common IoT scenarios, see the [IoT Hub quickstarts](https://docs.microsoft.com/azure/iot-hub/quickstart-send-telemetry-cli). There are quickstarts for multiple programming languages including C, Node.js, and Python.
+
+This page is an index of [Azure Policy](../governance/policy/overview.md) built-in policy
+definitions for Azure IoT Hub. For additional Azure Policy built-ins for other services,
+see [Azure Policy built-in definitions](../governance/policy/samples/built-in-policies.md).
+
+The name of each built-in policy definition links to the policy definition in the Azure portal. Use
+the link in the **GitHub** column to view the source on the
+[Azure Policy GitHub repo](https://github.com/Azure/azure-policy).
+
+## Azure IoT Hub
+
+[!INCLUDE [azure-policy-samples-rp-iot](../../includes/policy/samples/byrp/microsoft.devices.md)]
+
+## Next steps
+
+- See the built-ins on the [Azure Policy GitHub repo](https://github.com/Azure/azure-policy).
+- Review the [Azure Policy definition structure](../governance/policy/concepts/definition-structure.md).
+- Review [Understanding policy effects](../governance/policy/concepts/effects.md).