Merge pull request #86983 from DCtheGeek/dmc-arg-displaynames

Adding Include parameter example

Author: rjagiewich

articles/governance/resource-graph/first-query-azurecli.md

@@ -37,7 +37,7 @@ Docker image](https://hub.docker.com/r/microsoft/azure-cli/), or locally install
    az extension add --name resource-graph
    ```
 
-1. Validate that the extension has been installed and is the expected version (at least **0.1.11**):
+1. Validate that the extension has been installed and is the expected version (at least **1.0.0**):
 
    ```azurecli-interactive
    # Check the extension list (note that you may have other extensions installed)

articles/governance/resource-graph/first-query-powershell.md

@@ -48,7 +48,7 @@ The Resource Graph module for PowerShell is **Az.ResourceGraph**.
    Install-Module -Name Az.ResourceGraph
    ```
 
-1. Validate that the module has been imported and is the correct version (0.7.3):
+1. Validate that the module has been imported and is the latest version (0.7.5):
 
    ```azurepowershell-interactive
    # Get a list of commands for the imported Az.ResourceGraph module

articles/governance/resource-graph/samples/advanced.md

@@ -1,9 +1,9 @@
 ---
 title: Advanced query samples
-description: Use Azure Resource Graph to run some advanced queries, including VMSS capacity, listing all tags used, and matching virtual machines with regular expressions.
+description: Use Azure Resource Graph to run some advanced queries, including virtual machine scale set capacity, listing all tags used, and matching virtual machines with regular expressions.
 author: DCtheGeek
 ms.author: dacoulte
-ms.date: 01/23/2019
+ms.date: 08/29/2019
 ms.topic: quickstart
 ms.service: resource-graph
 manager: carmonm
@@ -23,7 +23,8 @@ We'll walk through the following advanced queries:
 > - [List all tag names](#list-all-tags)
 > - [Virtual machines matched by regex](#vm-regex)
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free) before you begin.
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free)
+before you begin.
 
 [!INCLUDE [az-powershell-update](../../../../includes/updated-for-az.md)]
 
@@ -39,8 +40,8 @@ validate your shell environment of choice.
 
 This query looks for virtual machine scale set resources and gets various details including the
 virtual machine size and the capacity of the scale set. The query uses the `toint()` function to
-cast the capacity to a number so that it can be sorted. Finally, the columns are renamed into
-custom named properties.
+cast the capacity to a number so that it can be sorted. Finally, the columns are renamed into custom
+named properties.
 
 ```kusto
 where type=~ 'microsoft.compute/virtualmachinescalesets'
@@ -77,8 +78,9 @@ Search-AzGraph -Query "project tags | summarize buildschema(tags)"
 
 ## <a name="vm-regex"></a>Virtual machines matched by regex
 
-This query looks for virtual machines that match a [regular expression](/dotnet/standard/base-types/regular-expression-language-quick-reference) (known as _regex_).
-The **matches regex \@** allows us to define the regex to match, which is `^Contoso(.*)[0-9]+$`. That regex definition is explained as:
+This query looks for virtual machines that match a [regular expression](/dotnet/standard/base-types/regular-expression-language-quick-reference)
+(known as _regex_). The **matches regex \@** allows us to define the regex to match, which is `^Contoso(.*)[0-9]+$`.
+That regex definition is explained as:
 
 - `^` - Match must start at the beginning of the string.
 - `Contoso` - The case-sensitive string.
@@ -105,8 +107,29 @@ az graph query -q "where type =~ 'microsoft.compute/virtualmachines' and name ma
 Search-AzGraph -Query "where type =~ 'microsoft.compute/virtualmachines' and name matches regex @'^Contoso(.*)[0-9]+$' | project name | order by name asc"
 ```
 
+## <a name="displaynames"></a>Include the tenant and subscription names with DisplayNames
+
+This query uses the new **Include** parameter with option _DisplayNames_ to add
+**subscriptionDisplayName** and **tenantDisplayName** to the results. This parameter is only
+available for Azure CLI and Azure PowerShell.
+
+```azurecli-interactive
+az graph query -q "limit 1" --include displayNames
+```
+
+```azurepowershell-interactive
+Search-AzGraph -Query "limit 1" -Include DisplayNames
+```
+
+> [!NOTE]
+> If the query doesn't use **project** to specify the returned properties,
+> **subscriptionDisplayName** and **tenantDisplayName** are automatically included in the results.
+> If the query does use **project**, each of the _DisplayName_ fields must be explicitly included in
+> the **project** or they won't be returned in the results, even when the **Include** parameter is
+> used.
+
 ## Next steps
 
 - See samples of [Starter queries](starter.md)
 - Learn more about the [query language](../concepts/query-language.md)
-- Learn to [explore resources](../concepts/explore-resources.md)
+- Learn to [explore resources](../concepts/explore-resources.md)