added new file, including images and links to new file, plus updataed TOC

Author: craigcaseyMSFT

articles/devtest-lab/TOC.md

@@ -42,7 +42,9 @@
 ## Manage reusable templates
 ### [Add a Git repository for artifacts and templates](devtest-lab-add-artifact-repo.md)
 ### [Use a resource manager template](devtest-lab-use-resource-manager-template.md)
-### [Create custom artifacts](devtest-lab-artifact-author.md)
+### Manage artifacts
+#### [Create custom artifacts](devtest-lab-artifact-author.md)
+#### [Diagnose artifact failures](devtest-lab-troubleshoot-artifact-failure.md)
 ### [Manage formulas](devtest-lab-manage-formulas.md)
 
 ## Manage virtual networks

articles/devtest-lab/devtest-lab-add-artifact-repo.md

@@ -98,5 +98,5 @@ When you create a VM, you'll be able to verify that the artifacts or templates a
 [!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
 
 ### Related blog posts
-* [How to troubleshoot failing Artifacts in AzureDevTestLabs](http://www.visualstudiogeeks.com/blog/DevOps/How-to-troubleshoot-failing-artifacts-in-AzureDevTestLabs)
+* [How to troubleshoot failing Artifacts in Azure DevTest Labs](devtest-lab-troubleshoot-artifact-failure.md)
 * [Join a VM to existing AD Domain using ARM template in Azure Dev Test Lab](http://www.visualstudiogeeks.com/blog/DevOps/Join-a-VM-to-existing-AD-domain-using-ARM-template-AzureDevTestLabs)

articles/devtest-lab/devtest-lab-artifact-author.md

@@ -23,13 +23,13 @@ ms.author: tarcher
 > 
 
 ## Overview
-**Artifacts** are used to deploy and configure your application after a VM is provisioned. An artifact consists of an artifact definition file and other script files that are stored in a folder in a git repository. Artifact definition files consist of JSON and expressions that you can use to specify what you want to install on a VM. For example, you can define the name of artifact, command to run, and parameters that are made available when the command is run. You can refer to other script files within the artifact definition file by name.
+**Artifacts** are used to deploy and configure your application after a VM is provisioned. An artifact consists of an artifact definition file and other script files that are stored in a folder in a git repository. Artifact definition files consist of JSON and expressions that you can use to specify what you want to install on a VM. For example, you can define the name of an artifact, command to run, and parameters that are made available when the command is run. You can refer to other script files within the artifact definition file by name.
 
 ## Artifact definition file format
 The following example shows the sections that make up the basic structure of a definition file.
 
     {
-      "$schema": "https://raw.githubusercontent.com/Azure/azure-devtestlab/master/schemas/2015-01-01/dtlArtifacts.json",
+      "$schema": "https://raw.githubusercontent.com/Azure/azure-devtestlab/master/schemas/2016-11-28/dtlArtifacts.json",
       "title": "",
       "description": "",
       "iconUri": "",
@@ -59,7 +59,7 @@ The following example shows the sections that make up the basic structure of a d
 ### Artifact parameters
 In the parameters section of the definition file, you specify which values a user can input when installing an artifact. You can refer to these values in the artifact install command.
 
-You define parameters will the following structure.
+You define parameters with the following structure.
 
     "parameters": {
         "<parameterName>": {
@@ -85,7 +85,7 @@ The allowed types are:
 ## Artifact expressions and functions
 You can use expression and functions to construct the artifact install command.
 Expressions are enclosed with brackets ([ and ]), and are evaluated when the artifact is installed. Expressions can appear anywhere in a JSON string value and always return another JSON value. If you need to use a literal string that starts with a bracket [, you must use two brackets [[.
-Typically, you use expressions with functions to construct a value. Just like in JavaScript, function calls are formatted as functionName(arg1,arg2,arg3)
+Typically, you use expressions with functions to construct a value. Just like in JavaScript, function calls are formatted as functionName(arg1,arg2,arg3).
 
 The following list shows common functions.
 
@@ -95,19 +95,19 @@ The following list shows common functions.
 The following example shows how to use expression and functions to construct a value.
 
     runCommand": {
-         "commandToExecute": "[concat('powershell.exe -File startChocolatey.ps1'
+         "commandToExecute": "[concat('powershell.exe -ExecutionPolicy bypass \"& ./startChocolatey.ps1'
     , ' -RawPackagesList ', parameters('packages')
     , ' -Username ', parameters('installUsername')
     , ' -Password ', parameters('installPassword'))]"
     }
 
 ## Create a custom artifact
-Create your custom artifact by following steps below:
+Create your custom artifact by following the steps below:
 
 1. Install a JSON editor - You will need a JSON editor to work with artifact definition files. We recommend using [Visual Studio Code](https://code.visualstudio.com/), which is available for Windows, Linux and OS X.
-2. Get a sample artifactfile.json - Check out the artifacts created by Azure DevTest Labs team at our [GitHub repository](https://github.com/Azure/azure-devtestlab) where we have created a rich library of artifacts that will help you create your own artifacts. Download an artifact definition file and make changes to it to create your own artifacts.
+2. Get a sample artifactfile.json - Check out the artifacts created by Azure DevTest Labs team at our [GitHub repository](https://github.com/Azure/azure-devtestlab), where we have created a rich library of artifacts that will help you create your own artifacts. Download an artifact definition file and make changes to it to create your own artifacts.
 3. Make use of IntelliSense - Leverage IntelliSense to see valid elements that can be used to construct an artifact definition file. You can also see the different options for values of an element. For example, IntelliSense show you the two choices of Windows or Linux when editing the **targetOsType** element.
-4. Store the artifact in a git repository
+4. Store the artifact in a [git repository](devtest-lab-add-artifact-repo.md).
 
    1. Create a separate directory for each artifact where the directory name is the same as the artifact name.
    2. Store the artifact definition file (artifactfile.json) in the directory you created.
@@ -116,12 +116,12 @@ Create your custom artifact by following steps below:
       Here is an example of how an artifact folder might look:
 
       ![Artifact git repo example](./media/devtest-lab-artifact-author/git-repo.png)
-5. Add the artifacts repository to the lab - Refer to the article, [Add a Git artifact repository to a lab](devtest-lab-add-artifact-repo.md).
+5. Add the artifacts repository to the lab - Refer to the article, [Add a Git repository for artifacts and templates](devtest-lab-add-artifact-repo.md).
 
 [!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
 
-## Related blog posts
-* [How to troubleshoot failing Artifacts in AzureDevTestLabs](http://www.visualstudiogeeks.com/blog/DevOps/How-to-troubleshoot-failing-artifacts-in-AzureDevTestLabs)
+## Related articles
+* [How to diagnose artifact failures in DevTest Labs](devtest-lab-troubleshoot-artifact-failure.md)
 * [Join a VM to existing AD Domain using ARM template in Azure Dev Test Lab](http://www.visualstudiogeeks.com/blog/DevOps/Join-a-VM-to-existing-AD-domain-using-ARM-template-AzureDevTestLabs)
 
 ## Next steps

articles/devtest-lab/devtest-lab-faq.md

@@ -246,7 +246,7 @@ A Microsoft account is what you use for almost everything you do with Microsoft
 >
 
 ### My artifact failed during VM creation. How do I troubleshoot it?
-Refer to the blog post, [How to troubleshoot failing Artifacts in AzureDevTestLabs](http://www.visualstudiogeeks.com/blog/DevOps/How-to-troubleshoot-failing-artifacts-in-AzureDevTestLabs) – written by one of our MVPs – to learn how to obtain logs regarding your failed artifact.
+Refer to [How to diagnose artifact failures in DevTest Labs](devtest-lab-troubleshoot-artifact-failure.md) to learn how to obtain logs regarding your failed artifact.
 
 ### Why isn't my existing virtual network saving properly?
 One possibility is that your virtual network name contains periods. If so, try removing the periods or replacing them with hyphens, and then try saving the virtual network again.

articles/devtest-lab/devtest-lab-troubleshoot-artifact-failure.md

@@ -0,0 +1,65 @@
+---
+title: Diagnose artifact failures in DevTest Labs VM | Microsoft Docs
+description: Learn how to troubleshoot artifact failures in DevTest Labs
+services: devtest-lab,virtual-machines
+documentationcenter: na
+author: tomarcher
+manager: douge
+editor: ''
+
+ms.assetid: 115e0086-3293-4adf-8738-9f639f31f918
+ms.service: devtest-lab
+ms.workload: na
+ms.tgt_pltfrm: na
+ms.devlang: na
+ms.topic: article
+ms.date: 08/18/2017
+ms.author: tarcher
+
+---
+# Diagnose artifact failures in the lab 
+After you have created an artifact, you can check to see if it succeeded or failed. Artifact logs in DevTest Labs provide information you can use to diagnose an artifact failure. There are a couple different ways you can view the artifact log information for a Windows VM.
+
+> [!NOTE]
+> To ensure that failures are correctly identified and explained, it is important that the artifact definition file is properly structured. For information about how to correctly construct an artifact definition file, see [Create custom artifacts](devtest-lab-artifact-author.md). And to see an example of a properly structured file, checkout this [artifact JSON file](https://github.com/Azure/azure-devtestlab/blob/master/Artifacts/windows-test-paramtypes/artifactfile.json).
+
+## Troubleshoot artifact failures using the Azure portal
+To use the Azure portal to diagnose failures during artifact creation, follow these steps:
+
+1) From the list of resources, select your lab.
+1) Choose the Windows VM that includes the artifact you want to investigate.
+1) In the main blade under **GENERAL**, choose **Artifacts**.
+
+   A list of artifacts associated with that VM appears, indicating the name of the artifact and its status.
+
+   ![Artifact git repo example](./media/devtest-lab-troubleshoot-artifact-failure/devtest-lab-artifacts-failure.png)
+
+1) Choose an artifact that shows a status of **Failed**.
+
+   This opens the artifact and shows an extension message that includes details about the failure of the artifact.
+
+   ![Artifact git repo example](./media/devtest-lab-troubleshoot-artifact-failure/devtest-lab-artifact-error.png)
+
+
+## Troubleshoot artifact failures from within the VM
+To view the artifact logs from within the virtual machine, follow these steps:
+
+1) Log in to the VM that contains the artifact you want to diagnose.
+1) Navigate to C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.9\Status where "1.9 is the CSE version number.
+
+   ![Artifact git repo example](./media/devtest-lab-troubleshoot-artifact-failure/devtest-lab-artifact-error-vm-status.png)
+
+
+1) Open the **status** file to view information that will help diagnose artifact failures for that VM.
+
+
+
+
+[!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
+
+## Related blog posts
+* [Join a VM to existing AD Domain using ARM template in Azure Dev Test Lab](http://www.visualstudiogeeks.com/blog/DevOps/Join-a-VM-to-existing-AD-domain-using-ARM-template-AzureDevTestLabs)
+
+## Next steps
+* Learn how to [add a Git repository to a lab](devtest-lab-add-artifact-repo.md).
+