diff --git a/src/SDKs/Batch/DataPlane/Azure.Batch/Generated/PoolUsageMetrics.cs b/src/SDKs/Batch/DataPlane/Azure.Batch/Generated/PoolUsageMetrics.cs
index ee972debc0c1..c2a6b4fea5c0 100644
--- a/src/SDKs/Batch/DataPlane/Azure.Batch/Generated/PoolUsageMetrics.cs
+++ b/src/SDKs/Batch/DataPlane/Azure.Batch/Generated/PoolUsageMetrics.cs
@@ -96,9 +96,17 @@ public double TotalCoreHours
         }
 
         /// <summary>
-        /// Gets the size of virtual machine in the pool. All virtual machines in a pool are the same size. Azure Batch supports 
-        /// all Azure virtual machine sizes except ExtraSmall.
+        /// Gets the size of the virtual machines in the pool.  All virtual machines in a pool are the same size.
         /// </summary>
+        /// <remarks>
+        /// <para>For information about available sizes of virtual machines for Cloud Services pools (pools created with 
+        /// a <see cref="CloudServiceConfiguration"/>), see https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/. 
+        /// Batch supports all Cloud Services VM sizes except ExtraSmall.</para><para>For information about available VM 
+        /// sizes for pools using images from the Virtual Machines Marketplace (pools created with a <see cref="VirtualMachineConfiguration"/>) 
+        /// see https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ or https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/. 
+        /// Batch supports all Azure VM sizes except STANDARD_A0 and those with premium storage (for example STANDARD_GS, 
+        /// STANDARD_DS, and STANDARD_DSV2 series).</para>
+        /// </remarks>
         public string VirtualMachineSize
         {
             get { return this.virtualMachineSize; }
diff --git a/src/SDKs/Batch/DataPlane/Tools/ObjectModelCodeGeneration/ObjectModelCodeGenerator/Spec/PoolUsageMetrics.json b/src/SDKs/Batch/DataPlane/Tools/ObjectModelCodeGeneration/ObjectModelCodeGenerator/Spec/PoolUsageMetrics.json
index 335c715d8c0d..5a9dac161eef 100644
--- a/src/SDKs/Batch/DataPlane/Tools/ObjectModelCodeGeneration/ObjectModelCodeGenerator/Spec/PoolUsageMetrics.json
+++ b/src/SDKs/Batch/DataPlane/Tools/ObjectModelCodeGeneration/ObjectModelCodeGenerator/Spec/PoolUsageMetrics.json
@@ -89,8 +89,8 @@
           "Key": {
             "Type": "string",
             "Name": "VirtualMachineSize",
-            "SummaryComment": "The size of virtual machine in the pool. All virtual machines in a pool are the same size. Azure Batch supports all Azure virtual machine sizes except ExtraSmall.",
-            "RemarksComment": null,
+            "SummaryComment": "The size of the virtual machines in the pool.  All virtual machines in a pool are the same size.",
+            "RemarksComment": "<para>For information about available sizes of virtual machines for Cloud Services pools (pools created with a <see cref=\"CloudServiceConfiguration\"/>), see https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/. Batch supports all Cloud Services VM sizes except ExtraSmall.</para><para>For information about available VM sizes for pools using images from the Virtual Machines Marketplace (pools created with a <see cref=\"VirtualMachineConfiguration\"/>) see https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ or https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/. Batch supports all Azure VM sizes except STANDARD_A0 and those with premium storage (for example STANDARD_GS, STANDARD_DS, and STANDARD_DSV2 series).</para>",
             "BoundAccess": "read",
             "UnboundAccess": "none"
           },