Add ProjectCollectionValidUsersGroupName parameter

Updated TfsUserMappingTool configuration to include a new parameter, `ProjectCollectionValidUsersGroupName`, in the YAML and JSON schema files. Clarified documentation for `MatchUsersByEmail` while keeping its functionality unchanged. These changes enhance the tool's ability to reference the valid users group during user mapping processes.

Author: MrHinsh

docs/data/classes/reference.tools.tfsusermappingtool.yaml

@@ -71,7 +71,8 @@ configurationSamples:
         "Microsoft.VSTS.Common.ClosedBy"
       ],
       "UserMappingFile": "C:\\temp\\userExport.json",
-      "MatchUsersByEmail": false
+      "MatchUsersByEmail": false,
+      "ProjectCollectionValidUsersGroupName": "Project Collection Valid Users"
     }
   sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
 description: The TfsUserMappingTool is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.
@@ -90,6 +91,10 @@ options:
   type: Boolean
   description: By default, users in source are mapped to target users by their display name. If this is set to true, then the users will be mapped by their email address first. If no match is found, then the display name will be used.
   defaultValue: missing XML code comments
+- parameterName: ProjectCollectionValidUsersGroupName
+  type: String
+  description: This is the regionalized "Project Collection Valid Users" group name. Default is "Project Collection Valid Users".
+  defaultValue: missing XML code comments
 - parameterName: UserMappingFile
   type: String
   description: This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.

docs/static/schema/configuration.schema.json

@@ -1444,6 +1444,10 @@
                   "description": "By default, users in source are mapped to target users by their display name. If this is set to true, then the users will be mapped by their email address first. If no match is found, then the display name will be used.",
                   "type": "boolean"
                 },
+                "projectCollectionValidUsersGroupName": {
+                  "description": "This is the regionalized \"Project Collection Valid Users\" group name. Default is \"Project Collection Valid Users\".",
+                  "type": "string"
+                },
                 "userMappingFile": {
                   "description": "This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.",
                   "type": "string"

docs/static/schema/schema.tools.tfsusermappingtool.json

@@ -17,6 +17,10 @@
       "description": "By default, users in source are mapped to target users by their display name. If this is set to true, then the users will be mapped by their email address first. If no match is found, then the display name will be used.",
       "type": "boolean"
     },
+    "projectCollectionValidUsersGroupName": {
+      "description": "This is the regionalized \"Project Collection Valid Users\" group name. Default is \"Project Collection Valid Users\".",
+      "type": "string"
+    },
     "userMappingFile": {
       "description": "This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.",
       "type": "string"