Merge pull request #8005 from MicrosoftDocs/users/jukullam/update-outdated-template-tasks

Update outdated tasks for DownloadBuildArtifacts@0 and vstest@2

Author: prmerger-automator[bot]

docs/pipelines/process/phases.md

@@ -723,35 +723,34 @@ When you run a pipeline on a self-hosted agent, by default, none of the subdirec
 
 ## Artifact download
 
-This example YAML file publishes the artifact `WebSite` and then downloads the artifact to `$(Pipeline.Workspace)`. The Deploy job only runs if the Build job is successful. 
+This example YAML file publishes the artifact `Website` and then downloads the artifact to `$(Pipeline.Workspace)`. The Deploy job only runs if the Build job is successful. 
 
 #### [YAML](#tab/yaml/)
 
 ```yaml
-# test and upload my code as an artifact named WebSite
+# test and upload my code as an artifact named Website
 jobs:
 - job: Build
   pool:
     vmImage: 'ubuntu-latest'
   steps:
   - script: npm test
-  - task: PublishBuildArtifacts@1
+  - task: PublishPipelineArtifact@1
     inputs:
-      pathtoPublish: '$(System.DefaultWorkingDirectory)'
-      artifactName: WebSite
+      artifactName: Website
+      targetPath: '$(System.DefaultWorkingDirectory)'
 
 # download the artifact and deploy it only if the build job succeeded
 - job: Deploy
   pool:
     vmImage: 'ubuntu-latest'
   steps:
   - checkout: none #skip checking out the default repository resource
-  - task: DownloadBuildArtifacts@0
-    displayName: 'Download Build Artifacts'
+  - task: DownloadPipelineArtifact@2
+    displayName: 'Download Pipeline Artifact'
     inputs:
-      artifactName: WebSite
-      downloadPath: $(Pipeline.Workspace)
-
+      artifactName: Website
+      targetPath: '$(Pipeline.Workspace)'
   dependsOn: Build
   condition: succeeded()
 ```

docs/pipelines/process/template-expressions.md

@@ -24,20 +24,22 @@ in an expression. Only predefined variables can be used in template expressions.
 For example, you define a template:
 
 ```yaml
-# File: steps/msbuild.yml
+# File: steps/vsbuild.yml
 
 parameters:
 - name: 'solution'
   default: '**/*.sln'
   type: string
 
 steps:
-- task: msbuild@1
+- task: VSBuild@1
   inputs:
     solution: ${{ parameters['solution'] }}  # index syntax
-- task: vstest@2
+- task: VSTest@3
   inputs:
-    solution: ${{ parameters.solution }}  # property dereference syntax
+    testSelector: 'testAssemblies' 
+    testAssemblyVer2: ${{ parameters.solution }} # property dereference syntax
+    searchFolder: '$(System.DefaultWorkingDirectory)' 
 ```
 
 Then you reference the template and pass it the optional `solution` parameter:
@@ -46,7 +48,7 @@ Then you reference the template and pass it the optional `solution` parameter:
 # File: azure-pipelines.yml
 
 steps:
-- template: steps/msbuild.yml
+- template: steps/vsbuild.yml
   parameters:
     solution: my.sln
 ```
@@ -113,9 +115,9 @@ jobs:
   steps:
   - script: cred-scan
   - ${{ parameters.preBuild }}
-  - task: msbuild@1
+  - task: VSBuild@1
   - ${{ parameters.preTest }}
-  - task: vstest@2
+  - task: VSTest@3
   - ${{ parameters.preSign }}
   - script: sign
 ```
@@ -150,8 +152,8 @@ jobs:
     arch: x86
     ${{ insert }}: ${{ parameters.additionalVariables }}
   steps:
-  - task: msbuild@1
-  - task: vstest@2
+  - task: VSBuild@1
+  - task: VSTest@3
 ```
 
 ```yaml
@@ -173,24 +175,24 @@ For example, to insert into a sequence in a template:
 
 parameters:
 - name: 'toolset'
-  default: msbuild
+  default: vsbuild
   type: string
   values:
-  - msbuild
+  - vsbuild
   - dotnet
 
 steps:
 # msbuild
 - ${{ if eq(parameters.toolset, 'msbuild') }}:
-  - task: msbuild@1
-  - task: vstest@2
+  - task: VSBuild@1
+  - task: VSTest@3
 
 # dotnet
 - ${{ if eq(parameters.toolset, 'dotnet') }}:
-  - task: dotnet@1
+  - task: UseDotNet@2
     inputs:
       command: build
-  - task: dotnet@1
+  - task: UseDotNet@2
     inputs:
       command: test
 ```

docs/pipelines/process/template-parameters.md

@@ -208,12 +208,14 @@ steps:
   env:
     SOLUTION: ${{ parameters.solution }}
   displayName: Check for required parameters
-- task: msbuild@1
+- task: VSBuild@1
   inputs:
     solution: ${{ parameters.solution }}
-- task: vstest@2
+- task: VSTest@3
   inputs:
-    solution: ${{ parameters.solution }}
+    testSelector: 'testAssemblies' 
+    testAssemblyVer2: ${{ parameters.solution }} 
+    searchFolder: '$(System.DefaultWorkingDirectory)' 
 ```
 
 To show that the template fails if it's missing the required parameter: