Align help text with OM doc comments

Author: jasper-schneider

src/ResourceManager/Batch/Commands.Batch/Pools/NewBatchPoolCommand.cs

@@ -51,11 +51,11 @@ public class NewBatchPoolCommand : BatchObjectModelCmdletBase
         [ValidateNotNullOrEmpty]
         public int? TargetDedicated { get; set; }
 
-        [Parameter(ParameterSetName = AutoScaleParameterSet, HelpMessage = "The AutoScale formula to use with the Pool.")]
+        [Parameter(ParameterSetName = AutoScaleParameterSet, HelpMessage = "The formula for automatically scaling the Pool.")]
         [ValidateNotNullOrEmpty]
         public string AutoScaleFormula { get; set; }
 
-        [Parameter(HelpMessage = "The maximum number of Tasks that can run on a VM.")]
+        [Parameter(HelpMessage = "The maximum number of Tasks that can run on a single VM.")]
         [ValidateNotNullOrEmpty]
         public int? MaxTasksPerVM { get; set; }
 
@@ -67,14 +67,14 @@ public class NewBatchPoolCommand : BatchObjectModelCmdletBase
         [ValidateNotNullOrEmpty]
         public IDictionary Metadata { get; set; }
 
-        [Parameter(HelpMessage = "The VMs in the Pool need to communicate with each other.")]
+        [Parameter(HelpMessage = "Set up the Pool for direct communication between dedicated VMs.")]
         public SwitchParameter Communication { get; set; }
 
-        [Parameter(HelpMessage = "The Task that will run on all VMs that belong to the pool. The Start Task runs when the VM is added to the pool or when it is restarted.")]
+        [Parameter(HelpMessage = "The start task specification for the Pool. The start task is run when a VM joins a Pool, or when the VM is rebooted or reimaged.")]
         [ValidateNotNullOrEmpty]
         public PSStartTask StartTask { get; set; }
 
-        [Parameter(HelpMessage = "Certificate References associated with the Pool. The referenced certificates will be installed on each VM in the Pool")]
+        [Parameter(HelpMessage = "Certificates associated with the Pool.")]
         [ValidateNotNullOrEmpty]
         public PSCertificateReference[] CertificateReferences { get; set; }
 

src/ResourceManager/Batch/Commands.Batch/Tasks/NewBatchTaskCommand.cs

@@ -40,11 +40,11 @@ public class NewBatchTaskCommand : BatchObjectModelCmdletBase
         [ValidateNotNullOrEmpty]
         public string Name { get; set; }
 
-        [Parameter(HelpMessage = "The command the Task will execute.")]
+        [Parameter(HelpMessage = "The commandline for the Task.")]
         [ValidateNotNullOrEmpty]
         public string CommandLine { get; set; }
 
-        [Parameter(HelpMessage = "Resource Files to add to the new Task. For each key/value pair, set the key to the Resource File path, and the value to the Resource File blob source.")]
+        [Parameter(HelpMessage = "Resource Files required by the Task. For each key/value pair, set the key to the Resource File path, and the value to the Resource File blob source.")]
         [ValidateNotNullOrEmpty]
         public IDictionary ResourceFiles { get; set; }
 
@@ -55,11 +55,11 @@ public class NewBatchTaskCommand : BatchObjectModelCmdletBase
         [Parameter(HelpMessage = "Run the Task in elevated mode.")]
         public SwitchParameter RunElevated { get; set; }
 
-        [Parameter(HelpMessage = "The Affinity Information for the Task.")]
+        [Parameter(HelpMessage = "The locality hints for the Task.")]
         [ValidateNotNullOrEmpty]
         public PSAffinityInformation AffinityInformation { get; set; }
 
-        [Parameter(HelpMessage = "The Task Constraints.")]
+        [Parameter(HelpMessage = "The execution constraints for the Task.")]
         [ValidateNotNullOrEmpty]
         public PSTaskConstraints TaskConstraints { get; set; }