Merge pull request #103878 from bandersmsft/master

cost-mgt-billing - updated budget article to add PS section

Author: PRMerger7

articles/cost-management-billing/costs/analyze-cost-data-azure-cost-management-power-bi-template-app.md

@@ -1,33 +1,33 @@
 ---
-title: Analyze Azure costs with the Power BI template app
-description: This article explains how to install and use the Azure Cost Management Power BI Template app.
+title: Analyze Azure costs with the Power BI App
+description: This article explains how to install and use the Azure Cost Management Power BI App.
 keywords:
 author: bandersmsft
 ms.author: banders
-ms.date: 01/30/2020
+ms.date: 02/10/2020
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.reviewer: benshy
 ---
 
-# Analyze cost with the Azure Cost Management Power BI template app for Enterprise Agreements (EA)
+# Analyze cost with the Azure Cost Management Power BI App for Enterprise Agreements (EA)
 
-This article explains how to install and use the Azure Cost Management Power BI Template app. The app helps you analyze and manage your Azure costs in Power BI. You can use the app to monitor costs, usage trends, and identify cost optimization options to reduce your expenditures.
+This article explains how to install and use the Azure Cost Management Power BI app. The app helps you analyze and manage your Azure costs in Power BI. You can use the app to monitor costs, usage trends, and identify cost optimization options to reduce your expenditures.
 
-You download the template app into Power BI Desktop. You can use the app as-is, or you can modify it to extend the default filters, views, and visualizations to customize for your needs. Then, use it to join additional data to create customized reports to get holistic views of your overall business cost.
+You download the app into Power BI Desktop. You can use the app as-is, or you can modify it to extend the default filters, views, and visualizations to customize for your needs. Then, use it to join additional data to create customized reports to get holistic views of your overall business cost.
 
-The Azure Cost Management template app currently supports only customers with an [Enterprise Agreement](https://azure.microsoft.com/pricing/enterprise-agreement/).
+The Azure Cost Management Power BI App currently supports only customers with an [Enterprise Agreement](https://azure.microsoft.com/pricing/enterprise-agreement/).
 
 ## Prerequisites
 
-- A [Power BI Pro license](/power-bi/service-self-service-signup-for-power-bi) to install and use the Power BI template app
+- A [Power BI Pro license](/power-bi/service-self-service-signup-for-power-bi) to install and use the app
 - To connect to data, you must use an [Enterprise Administrator](../manage/understand-ea-roles.md) account
 
 ## Installation steps
 
 To install the app:
 
-1. Open [Azure Cost Management Power BI Template app](https://aka.ms/costmgmt/ACMApp).
+1. Open [Azure Cost Management Power BI App](https://aka.ms/costmgmt/ACMApp).
 2. On the Power BI AppSource page, select **Get it now**.
 3. Select **Continue** to agree to the terms of use and privacy policy.
 4. In the **Install this Power BI app** box, select **Install**.
@@ -49,9 +49,9 @@ To install the app:
 
 After the data refresh is complete, select the Azure Cost Management App to view the pre-created reports.
 
-## Reports available with the template app
+## Reports available with the app
 
-The following reports are available in the Azure Cost Management Power BI template app.
+The following reports are available in the app.
 
 **Getting Started** - Provides useful links to documentation and links to provide feedback.
 
@@ -122,11 +122,11 @@ For details about how to use the report, see the [VM RI Coverage (shared recomme
 
 ## Data reference
 
-The following information summarizes the data available through the Power BI template app. There's also links to APIs that give in-depth details for data fields and values.
+The following information summarizes the data available through the app. There's also links to APIs that give in-depth details for data fields and values.
 
 | **Table reference** | **Description** |
 | --- | --- |
-| **AutoFitComboMeter** | Data included in the template app to normalize the RI recommendation and usage to the smallest size in the instance family group. |
+| **AutoFitComboMeter** | Data included in the app to normalize the RI recommendation and usage to the smallest size in the instance family group. |
 | [**Balance summary**](/rest/api/billing/enterprise/billing-enterprise-api-balance-summary#response) | Summary of the balance for Enterprise Agreements. |
 | [**Budgets**](/rest/api/consumption/budgets/get#definitions) | Budget details to view actual costs or usage against existing budget targets. |
 | [**Pricesheets**](/rest/api/billing/enterprise/billing-enterprise-api-pricesheet#see-also) | Applicable meter rates for the provided billing profile or EA enrollment. |

articles/cost-management-billing/costs/tutorial-acm-create-budgets.md

@@ -28,6 +28,7 @@ In this tutorial, you learn how to:
 
 > [!div class="checklist"]
 > * Create a budget in the Azure portal
+> * Create and edit budgets with PowerShell
 > * Edit a budget
 
 ## Prerequisites
@@ -86,6 +87,36 @@ After you create a budget, it is shown in cost analysis. Viewing your budget aga
 
 In the preceding example, you created a budget for a subscription. You can also create a budget for a resource group. If you want to create a budget for a resource group, navigate to **Cost Management + Billing** > **Subscriptions** > select a subscription > **Resource groups** > select a resource group > **Budgets** > and then **Add** a budget.
 
+## Create and edit budgets with PowerShell
+
+EA customers can create and edit budgets programmatically using the Azure PowerShell module.  To download the latest version of Azure PowerShell, run the following command:
+
+```azurepowershell-interactive
+install-module -name AzureRm 
+```
+
+The following example commands create a budget.
+
+```azurepowershell-interactive
+#Sign into Azure Powershell with your account
+
+Connect-AzureRmAccount
+
+#Select a subscription to to monitor with a budget
+
+select-AzureRmSubscription -Subscription "Your Subscription"
+
+#Create an action group email receiver and corresponding action group
+
+$email1 = New-AzureRmActionGroupReceiver -EmailAddress [email protected] -Name EmailReceiver1
+$ActionGroupId = (Set-AzureRmActionGroup -ResourceGroupName YourResourceGroup -Name TestAG -ShortName TestAG -Receiver $email1).Id
+
+#Create a monthly budget that sends an email and triggers an Action Group to send a second email. Make sure the StartDate for your monthly budget is set to the first day of the current month. Note that Action Groups can also be used to trigger automation such as Azure Functions or Webhooks.
+
+New-AzureRmConsumptionBudget -Amount 100 -Name TestPSBudget -Category Cost -StartDate 2020-02-01 -TimeGrain Monthly -EndDate 2022-12-31 -ContactEmail [email protected] -NotificationKey Key1 -NotificationThreshold 0.8 -NotificationEnabled -ContactGroup $ActionGroupId
+```
+
+
 ## Costs in budget evaluations
 
 Budget cost evaluations now include reserved instance and purchase data. If the charges apply to you, then you might receive alerts as charges are incorporated into your evaluations. We recommend that you sign in to the [Azure portal](https://portal.azure.com) to verify that budget thresholds are properly configured to account for the new costs. Your Azure billed charges aren't changed. Budgets now evaluate against a more complete set of your costs. If the charges don't apply to you, then your budget behavior remains unchanged.
@@ -132,6 +163,7 @@ In this tutorial, you learned how to:
 
 > [!div class="checklist"]
 > * Create a budget in the Azure portal
+> * Create and edit budgets with PowerShell
 > * Edit a budget
 
 Advance to the next tutorial to create a recurring export for your cost management data.