update comments and a param alias

src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/generated.py

@@ -164,6 +164,12 @@ build_operation("vm",
                 ],
                 command_table, PARAMETER_ALIASES)
 
+vm_param_aliases = {
+    'name': {
+        'name': '--name -n'
+        }
+    }
+
 build_operation('vm',
                 'vm',
                 lambda _: get_mgmt_service_client(VMClient, VMClientConfig),
@@ -172,4 +178,5 @@ build_operation('vm',
                                           LongRunningOperation(L('Creating virtual machine'), L('Virtual machine created')),
                                           'create')
                 ],
-                command_table)
+                command_table,
+                vm_param_aliases)

src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/azuredeploy.json

@@ -190,7 +190,7 @@
       "type": "string",
       "defaultValue": "Standard_A2",
       "metadata": {
-        "description": "The VM Size that should be created."
+        "description": "The VM Size that should be created (e.g. Standard_A2)"
       }
     },
     "sshKeyPath": {

src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/models/deployment_vm.py

@@ -79,7 +79,7 @@ class DeploymentVM(Model):
     :type storage_account_name: str
     :param storage_redundancy_type: The VM storage type.
     :type storage_redundancy_type: str
-    :param size: The VM Size that should be created.
+    :param size: The VM Size that should be created  (e.g. Standard_A2)
     :type size: str
     :param public_ip_address_type: Use a public IP Address for the VM Nic.
      (new, existing or none).

src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/operations/vm_operations.py

@@ -97,7 +97,7 @@ class VMOperations(object):
         :type storage_account_name: str
         :param storage_redundancy_type: The VM storage type.
         :type storage_redundancy_type: str
-        :param size: The VM Size that should be created.
+        :param size: The VM Size that should be created  (e.g. Standard_A2)
         :type size: str
         :param public_ip_address_type: Use a public IP Address for the VM
          Nic. (new, existing or none).

src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/swagger_create_vm.json

@@ -560,7 +560,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "The VM Size that should be created.",
+          "description": "The VM Size that should be created  (e.g. Standard_A2)",
           "x-ms-client-name": "size"
         }
       }