Merge pull request #114049 from DCtheGeek/dmc-bp-mayreview

Freshness reviews

Author: PRMerger14

articles/governance/blueprints/concepts/deployment-stages.md

@@ -1,7 +1,7 @@
 ---
 title: Stages of a blueprint deployment
 description: Learn the security and artifact related steps the Azure Blueprints services goes through while creating a blueprint assignment.
-ms.date: 11/13/2019
+ms.date: 05/06/2020
 ms.topic: conceptual
 ---
 # Stages of a blueprint deployment
@@ -32,8 +32,8 @@ Blueprints service principal doesn't get and doesn't need owner rights on the su
 
 The rights are granted automatically if the assignment is done through the portal. However, if the
 assignment is done through the REST API, granting the rights needs to be done with a separate API
-call. The Azure Blueprints AppId is `f71766dc-90d9-4b7d-bd9d-4499c4331c3f`, but the service principal
-varies by tenant. Use
+call. The Azure Blueprints AppId is `f71766dc-90d9-4b7d-bd9d-4499c4331c3f`, but the service
+principal varies by tenant. Use
 [Azure Active Directory Graph API](../../../active-directory/develop/active-directory-graph-api.md)
 and REST endpoint [servicePrincipals](/graph/api/resources/serviceprincipal) to get the service
 principal. Then, grant the Azure Blueprints the _Owner_ role through the

articles/governance/blueprints/concepts/lifecycle.md

@@ -1,7 +1,7 @@
 ---
 title: Understand the lifecycle of a blueprint
 description: Learn about the lifecycle that a blueprint definition goes through and details about each stage, including updating and removing blueprint assignments.
-ms.date: 07/30/2019
+ms.date: 05/06/2020
 ms.topic: conceptual
 ---
 # Understand the lifecycle of an Azure Blueprint

articles/governance/blueprints/concepts/sequencing-order.md

@@ -1,7 +1,7 @@
 ---
 title: Understand the deployment sequence order
 description: Learn about the default order that blueprint artifacts are deployed in during a blueprint assignment and how to customize the deployment order.
-ms.date: 08/22/2019
+ms.date: 05/06/2020
 ms.topic: conceptual
 ---
 # Understand the deployment sequence in Azure Blueprints
@@ -50,9 +50,10 @@ definition, for resource groups, and artifact objects support this property. `de
 array of artifact names that the particular artifact needs to be created before it's created.
 
 > [!NOTE]
-> When creating blueprint objects, each artifact resource gets its name from the filename, if using [PowerShell](/powershell/module/az.blueprint/new-azblueprintartifact),
-> or the URL endpoint, if using [REST API](/rest/api/blueprints/artifacts/createorupdate).
-> _resourceGroup_ references in artifacts must match those defined in the blueprint definition.
+> When creating blueprint objects, each artifact resource gets its name from the filename, if using
+> [PowerShell](/powershell/module/az.blueprint/new-azblueprintartifact), or the URL endpoint, if
+> using [REST API](/rest/api/blueprints/artifacts/createorupdate). _resourceGroup_ references in
+> artifacts must match those defined in the blueprint definition.
 
 ### Example - ordered resource group
 
@@ -151,11 +152,11 @@ During the creation process, a topological sort is used to create the dependency
 blueprints artifacts. The check makes sure each level of dependency between resource groups and
 artifacts is supported.
 
-If an artifact dependency is declared that wouldn't alter the default order, then no change is
-made. An example is a resource group that depends on a subscription level policy. Another example
-is a resource group 'standard-rg' child policy assignment that depends on resource group
-'standard-rg' child role assignment. In both cases, the `dependsOn` wouldn't have altered the
-default sequencing order and no changes would be made.
+If an artifact dependency is declared that wouldn't alter the default order, then no change is made.
+An example is a resource group that depends on a subscription level policy. Another example is a
+resource group 'standard-rg' child policy assignment that depends on resource group 'standard-rg'
+child role assignment. In both cases, the `dependsOn` wouldn't have altered the default sequencing
+order and no changes would be made.
 
 ## Next steps
 

articles/governance/blueprints/create-blueprint-powershell.md

@@ -1,7 +1,7 @@
 ---
 title: "Quickstart: Create a blueprint with PowerShell"
 description: In this quickstart, you use Azure Blueprints to create, define, and deploy artifacts using the PowerShell.
-ms.date: 11/21/2019
+ms.date: 05/06/2020
 ms.topic: quickstart
 ---
 # Quickstart: Define and Assign an Azure Blueprint with PowerShell
@@ -33,7 +33,7 @@ a role assignment on the resource group.
 > When using PowerShell, the _blueprint_ object is created first. For each _artifact_ to be added
 > that has parameters, the parameters need to be defined in advance on the initial _blueprint_.
 
-1. Create the initial _blueprint_ object. The **BlueprintFile** parameter takes a JSON file which
+1. Create the initial _blueprint_ object. The **BlueprintFile** parameter takes a JSON file that
    includes properties about the blueprint, any resource groups to create, and all of the blueprint
    level parameters. The parameters are set during assignment and used by the artifacts added in
    later steps.
@@ -348,7 +348,8 @@ lock, and blueprint parameters, use the matching PowerShell parameters on the
 
 1. Run the blueprint deployment by assigning it to a subscription. As the **contributors** and
    **owners** parameters require an array of objectIds of the principals to be granted the role
-   assignment, use [Azure Active Directory Graph API](../../active-directory/develop/active-directory-graph-api.md)
+   assignment, use
+   [Azure Active Directory Graph API](../../active-directory/develop/active-directory-graph-api.md)
    for gathering the objectIds for use in the **AssignmentFile** for your own users, groups, or
    service principals.
 

articles/governance/blueprints/how-to/configure-for-blueprint-operator.md

@@ -1,7 +1,7 @@
 ---
-title: Setup your environment for Blueprint Operator
+title: Set up your environment for Blueprint Operator
 description: Learn how to configure your Azure environment for use with the Blueprint Operator built-in role-based access control (RBAC) role.
-ms.date: 08/26/2019
+ms.date: 05/06/2020
 ms.topic: how-to
 ---
 # Configure your environment for a Blueprint Operator
@@ -45,8 +45,9 @@ of permissions.
    of **Managed Identity Operator** to the account or security group. Scope the role assignment to
    the new user-assigned managed identity.
 
-1. As the **Blueprint Operator**, [assign a blueprint](../create-blueprint-portal.md#assign-a-blueprint)
-   that uses the new user-assigned managed identity.
+1. As the **Blueprint Operator**,
+   [assign a blueprint](../create-blueprint-portal.md#assign-a-blueprint) that uses the new
+   user-assigned managed identity.
 
 ## Next steps
 

articles/governance/blueprints/how-to/import-export-ps.md

@@ -1,7 +1,7 @@
 ---
 title: Import and export blueprints with PowerShell
 description: Learn how to work with your blueprint definitions as code. Share, source control, and manage them using the export and import commands.
-ms.date: 09/03/2019
+ms.date: 05/06/2020
 ms.topic: how-to
 ---
 # Import and export blueprint definitions with PowerShell
@@ -28,12 +28,14 @@ This article assumes a moderate working knowledge of Azure Blueprints. If you ha
 work through the following articles:
 
 - [Create a blueprint in the portal](../create-blueprint-portal.md)
-- Read about [deployment stages](../concepts/deployment-stages.md) and [the blueprint lifecycle](../concepts/lifecycle.md)
-- [Creating](../create-blueprint-powershell.md) and [managing](./manage-assignments-ps.md)
-blueprint definitions and assignments with PowerShell
+- Read about [deployment stages](../concepts/deployment-stages.md) and
+  [the blueprint lifecycle](../concepts/lifecycle.md)
+- [Creating](../create-blueprint-powershell.md) and [managing](./manage-assignments-ps.md) blueprint
+  definitions and assignments with PowerShell
 
-If it isn't already installed, follow the instructions in [Add the Az.Blueprint module](./manage-assignments-ps.md#add-the-azblueprint-module)
-to install and validate the **Az.Blueprint** module from the PowerShell Gallery.
+If it isn't already installed, follow the instructions in
+[Add the Az.Blueprint module](./manage-assignments-ps.md#add-the-azblueprint-module) to install and
+validate the **Az.Blueprint** module from the PowerShell Gallery.
 
 ## Folder structure of a blueprint definition
 
@@ -96,8 +98,9 @@ definition can be useful for sharing, backup, or placing into source control.
 ## Import your blueprint definition
 
 Once you have either an [exported blueprint definition](#export-your-blueprint-definition) or have a
-manually created blueprint definition in the [required folder structure](#folder-structure-of-a-blueprint-definition),
-you can import that blueprint definition to a different management group or subscription.
+manually created blueprint definition in the
+[required folder structure](#folder-structure-of-a-blueprint-definition), you can import that
+blueprint definition to a different management group or subscription.
 
 For examples of built-in blueprint definitions, see the
 [Azure Blueprint GitHub repo](https://github.com/Azure/azure-blueprints/tree/master/samples/001-builtins).
@@ -122,7 +125,8 @@ For examples of built-in blueprint definitions, see the
    Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'
    ```
 
-Once the blueprint definition is imported, [assign it with PowerShell](./manage-assignments-ps.md#create-blueprint-assignments).
+Once the blueprint definition is imported,
+[assign it with PowerShell](./manage-assignments-ps.md#create-blueprint-assignments).
 
 For information about creating advanced blueprint definitions, see the following articles:
 

articles/governance/blueprints/how-to/manage-assignments-ps.md

@@ -1,7 +1,7 @@
 ---
 title: How to manage assignments with PowerShell
 description: Learn how to manage blueprint assignments with the official Azure Blueprints PowerShell module, Az.Blueprint.
-ms.date: 09/30/2019
+ms.date: 05/06/2020
 ms.topic: how-to
 ---
 # How to manage assignments with PowerShell
@@ -20,8 +20,10 @@ with the [Azure PowerShell Docker image](https://hub.docker.com/r/azuresdk/azure
 
 The Azure Blueprints module requires the following software:
 
-- Azure PowerShell 1.5.0 or higher. If it isn't yet installed, follow [these instructions](/powershell/azure/install-az-ps).
-- PowerShellGet 2.0.1 or higher. If it isn't installed or updated, follow [these instructions](/powershell/scripting/gallery/installing-psget).
+- Azure PowerShell 1.5.0 or higher. If it isn't yet installed, follow
+  [these instructions](/powershell/azure/install-az-ps).
+- PowerShellGet 2.0.1 or higher. If it isn't installed or updated, follow
+  [these instructions](/powershell/scripting/gallery/installing-psget).
 
 ### Install the module
 
@@ -228,11 +230,12 @@ ResourceGroups    : ResourceGroup
 
 ### Example 2: Use a JSON assignment definition file
 
-The following example creates nearly the same assignment as [Example 1](#example-1-provide-parameters).
-Instead of passing parameters to the cmdlet, the example shows use of a JSON assignment definition
-file and the **AssignmentFile** parameter. Additionally, the **excludedPrincipals** property is
-configured as part of **locks**. There isn't a PowerShell parameter for **excludedPrincipals** and
-the property can only be configured by setting it through the JSON assignment definition file.
+The following example creates nearly the same assignment as
+[Example 1](#example-1-provide-parameters). Instead of passing parameters to the cmdlet, the example
+shows use of a JSON assignment definition file and the **AssignmentFile** parameter. Additionally,
+the **excludedPrincipals** property is configured as part of **locks**. There isn't a PowerShell
+parameter for **excludedPrincipals** and the property can only be configured by setting it through
+the JSON assignment definition file.
 
 ```json
 {
@@ -286,7 +289,8 @@ that the `New-AzBlueprintAssignment` cmdlet does, allowing anything that was set
 to be updated. The exceptions are the _Name_, _Blueprint_, and _SubscriptionId_. Only the values
 provided are updated.
 
-To understand what happens when updating a blueprint assignment, see [rules for updating assignments](./update-existing-assignments.md#rules-for-updating-assignments).
+To understand what happens when updating a blueprint assignment, see
+[rules for updating assignments](./update-existing-assignments.md#rules-for-updating-assignments).
 
 - **Name** [required]
   - Specifies the name of the blueprint assignment to update
@@ -381,7 +385,7 @@ $blueprintAssignment = Get-AzBlueprintAssignment -Name 'Assignment-lock-resource
 Remove-AzBlueprintAssignment -InputObject $blueprintAssignment -SubscriptionId '{subId}'
 ```
 
-## End-to-end code example
+## Code example
 
 Bringing all the steps together, the following example gets the blueprint definition, then creates,
 updates, and removes a blueprint assignment in the specific subscription represented as `{subId}`:

articles/governance/blueprints/overview.md

@@ -1,7 +1,7 @@
 ---
 title: Overview of Azure Blueprints
 description: Understand how the Azure Blueprints service enables you to create, define, and deploy artifacts in your Azure environment.
-ms.date: 11/21/2019
+ms.date: 05/06/2020
 ms.topic: overview
 ---
 # What is Azure Blueprints?
@@ -11,7 +11,7 @@ Azure Blueprints enables cloud architects and central information technology gro
 repeatable set of Azure resources that implements and adheres to an organization's standards,
 patterns, and requirements. Azure Blueprints makes it possible for development teams to rapidly
 build and stand up new environments with trust they're building within organizational compliance
-with a set of built-in components -- such as networking -- to speed up development and delivery.
+with a set of built-in components, such as networking, to speed up development and delivery.
 
 Blueprints are a declarative way to orchestrate the deployment of various resource templates and
 other artifacts such as:
@@ -21,18 +21,18 @@ other artifacts such as:
 - Azure Resource Manager templates
 - Resource Groups
 
-The Azure Blueprints service is backed by the globally distributed [Azure Cosmos DB](../../cosmos-db/introduction.md).
-Blueprint objects are replicated to multiple Azure regions. This replication provides low latency,
-high availability, and consistent access to your blueprint objects, regardless of which region
-Azure Blueprints deploys your resources to.
+The Azure Blueprints service is backed by the globally distributed
+[Azure Cosmos DB](../../cosmos-db/introduction.md). Blueprint objects are replicated to multiple
+Azure regions. This replication provides low latency, high availability, and consistent access to
+your blueprint objects, regardless of which region Azure Blueprints deploys your resources to.
 
 ## How it's different from Resource Manager templates
 
 The service is designed to help with _environment setup_. This setup often consists of a set of
 resource groups, policies, role assignments, and Resource Manager template deployments. A blueprint
 is a package to bring each of these _artifact_ types together and allow you to compose and version
-that package -- including through a CI/CD pipeline. Ultimately, each is assigned to a subscription
-in a single operation that can be audited and tracked.
+that package, including through a CI/CD pipeline. Ultimately, each is assigned to a subscription in
+a single operation that can be audited and tracked.
 
 Nearly everything that you want to include for deployment in Azure Blueprints can be accomplished
 with a Resource Manager template. However, a Resource Manager template is a document that doesn't

articles/governance/blueprints/tutorials/protect-new-resources.md

@@ -1,7 +1,7 @@
 ---
 title: "Tutorial: Protect new resources with locks"
 description: In this tutorial, you use the Azure Blueprints resource locks options Read Only and Do Not Delete to protect newly deployed resources.
-ms.date: 11/21/2019
+ms.date: 05/06/2020
 ms.topic: tutorial
 ---
 # Tutorial: Protect new resources with Azure Blueprints resource locks