diff --git a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/generated.py b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/generated.py
index 39618f946b2..86efddfa4bb 100644
--- a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/generated.py
+++ b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/generated.py
@@ -224,7 +224,6 @@ def __call__(self, parser, namespace, values, option_string=None):
 extra_parameters = [
     {
         'name': '--image',
-        'help': 'The OS image.  Supported values: Common OS (e.g. Win2012R2Datacenter), URN (e.g. "publisher:offer:sku:version"), or existing VHD URI.',
         'action': VMImageFieldAction
         },
     {
@@ -241,20 +240,25 @@ def __call__(self, parser, namespace, values, option_string=None):
                 - name: --image
                   type: string
                   required: false
-                  short-summary: OS image
+                  short-summary: OS image (Common, URN or URI).
                   long-summary: |
-                    Common OS types: CentOS, CoreOS, Debian, openSUSE, RHEL, SLES, UbuntuLTS,
-                    Win2012R2Datacenter, Win2012Datacenter, Win2008R2SP1
+                    Common OS types: CentOS, CoreOS, Debian, openSUSE, RHEL, SLES, UbuntuLTS, Win2012R2Datacenter, Win2012Datacenter, Win2008R2SP1
                     Example URN: canonical:Ubuntu_Snappy_Core:15.04:2016.0318.1949
                     Example URI: http://<storageAccount>.blob.core.windows.net/vhds/osdiskimage.vhd
                   populator-commands: 
                     - az vm image list
                     - az vm image show
+                - name: --ssh-key-value
+                  short-summary: SSH key file value or key file path.
             examples:
                 - name: Create a simple Windows Server VM with private IP address
                   text: >
                     az vm create --image Win2012R2Datacenter --admin-username myadmin --admin-password Admin_001 
                     -l "West US" -g myvms --name myvm001
+                - name: Create a simple Windows Server VM with public IP address and DNS entry
+                  text: >
+                    az vm create --image Win2012R2Datacenter --admin-username myadmin --admin-password Admin_001 
+                    -l "West US" -g myvms --name myvm001 --public-ip-address-type new --dns-name-for-public-ip myGloballyUniqueVmDnsName
                 - name: Create a Linux VM with SSH key authentication, add a public DNS entry and add to an existing Virtual Network and Availability Set.
                   text: >
                     az vm create --image canonical:Ubuntu_Snappy_Core:15.04:2016.0318.1949
diff --git a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/azuredeploy.json b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/azuredeploy.json
index 98c91eb9c8f..752b979ee1d 100644
--- a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/azuredeploy.json
+++ b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/azuredeploy.json
@@ -31,7 +31,7 @@
         "sshkey"
       ],
       "metadata": {
-        "description": "Authentication method: password-only or add ssh-keys (Linux-only)."
+        "description": "Password or SSH Public Key authentication."
       }
     },
     "availabilitySetId": {
@@ -56,7 +56,7 @@
       "type": "string",
       "defaultValue": "",
       "metadata": {
-        "description": "Globally unique DNS Name for the Public IP used to access the Virtual Machine."
+        "description": "Globally unique DNS Name for the Public IP used to access the Virtual Machine.  Requires a new public IP to be created by setting Public IP Address Type to New."
       }
     },
     "dnsNameType": {
@@ -67,7 +67,7 @@
         "new"
       ],
       "metadata": {
-        "description": "Associate VMs with a public IP address to a DNS name (new or none)."
+        "description": "Associate VMs with a public IP address to a DNS name."
       }
     },
     "location": {
@@ -81,7 +81,7 @@
       "type": "string",
       "minLength": 1,
       "metadata": {
-        "description": "The VM resource name."
+        "description": "The VM name."
       }
     },
     "osDiskName": {
@@ -154,7 +154,7 @@
         "Static"
       ],
       "metadata": {
-        "description": "Dynamic of Static private IP address allocation."
+        "description": "Private IP address allocation method."
       }
     },
     "publicIpAddressAllocation": {
@@ -165,7 +165,7 @@
         "Static"
       ],
       "metadata": {
-        "description": "Dynamic or Static public IP address allocation."
+        "description": "Public IP address allocation method."
       }
     },
     "publicIpAddressName": {
@@ -184,21 +184,21 @@
         "existing"
       ],
       "metadata": {
-        "description": "Use a public IP Address for the VM Nic. (new, existing or none)."
+        "description": "Use a public IP Address for the VM Nic."
       }
     },
     "size": {
       "type": "string",
       "defaultValue": "Standard_A2",
       "metadata": {
-        "description": "The VM Size that should be created (e.g. Standard_A2)"
+        "description": "The VM Size that should be created.  See https://azure.microsoft.com/en-us/pricing/details/virtual-machines/ for size info."
       }
     },
-    "sshKeyPath": {
+    "sshDestKeyPath": {
       "type": "string",
       "defaultValue": "[concat('/home/',parameters('adminUsername'),'/.ssh/authorized_keys')]",
       "metadata": {
-        "description": "VM file path for SSH key."
+        "description": "Destination file path on VM for SSH key."
       }
     },
     "sshKeyValue": {
@@ -237,14 +237,14 @@
       "type": "string",
       "defaultValue": "Standard_LRS",
       "metadata": {
-        "description": "The VM storage type."
+        "description": "The VM storage type (Standard_LRS, Standard_GRS, Standard_RAGRS)."
       }
     },
     "subnetIpAddressPrefix": {
       "type": "string",
       "defaultValue": "10.0.0.0/24",
       "metadata": {
-        "description": "The subnet address type."
+        "description": "The subnet address prefix in CIDR format."
       }
     },
     "subnetName": {
@@ -258,7 +258,7 @@
       "type": "string",
       "defaultValue": "10.0.0.0/16",
       "metadata": {
-        "description": "The IP address prefix."
+        "description": "The virtual network IP address prefix in CIDR format."
       }
     },
     "virtualNetworkName": {
@@ -460,7 +460,7 @@
           "osDiskName": { "value": "[parameters('osDiskName')]" },
           "osDiskUri":  { "value": "[parameters('osDiskUri')]"},
           "sshKeyValue": { "value": "[parameters('sshKeyValue')]" },
-          "sshKeyPath": { "value": "[parameters('sshKeyPath')]" },
+          "sshKeyPath": { "value": "[parameters('sshDestKeyPath')]" },
           "availabilitySetId": { "value": "[variables('availSetId')]" },
           "location": { "value": "[parameters('location')]" }
         }
diff --git a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/models/deployment_vm.py b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/models/deployment_vm.py
index c8e9042f227..974d360ce44 100644
--- a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/models/deployment_vm.py
+++ b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/models/deployment_vm.py
@@ -29,13 +29,14 @@ class DeploymentVM(Model):
     :type storage_container_name: str
     :param virtual_network_name: Name of virtual network to add VM to.
     :type virtual_network_name: str
-    :param subnet_ip_address_prefix: The subnet address type.
+    :param subnet_ip_address_prefix: The subnet address prefix in CIDR format.
     :type subnet_ip_address_prefix: str
-    :param private_ip_address_allocation: Dynamic of Static private IP
-     address allocation.
+    :param private_ip_address_allocation: Private IP address allocation
+     method.
     :type private_ip_address_allocation: str
     :param dns_name_for_public_ip: Globally unique DNS Name for the Public IP
-     used to access the Virtual Machine.
+     used to access the Virtual Machine.  Requires a new public IP to be
+     created by setting Public IP Address Type to New.
     :type dns_name_for_public_ip: str
     :param storage_account_type: Whether to use an existing storage account
      or create a new one. Possible values include: 'new', 'existing'. Default
@@ -71,29 +72,32 @@ class DeploymentVM(Model):
     :type os_version: str
     :param os_disk_name: Name of new VM OS disk.
     :type os_disk_name: str
-    :param ssh_key_path: VM file path for SSH key.
-    :type ssh_key_path: str
+    :param ssh_dest_key_path: VM file path for SSH key.
+    :type ssh_dest_key_path: str
     :param os_offer: The OS Offer to install.
     :type os_offer: str
-    :param public_ip_address_allocation: Dynamic or Static public IP address
-     allocation. Possible values include: 'Dynamic', 'Static'. Default value:
-     "Dynamic" .
+    :param public_ip_address_allocation: Public IP address allocation method.
+     Possible values include: 'Dynamic', 'Static'. Default value: "Dynamic" .
     :type public_ip_address_allocation: str
-    :param authentication_type: Authentication method: password-only or add
-     ssh-keys (Linux-only). Possible values include: 'password', 'sshkey'.
-     Default value: "password" .
+    :param authentication_type: Password or SSH Public Key authentication.
+     Possible values include: 'password', 'sshkey'. Default value: "password"
+     .
     :type authentication_type: str
     :param storage_account_name: Name of storage account for the VM OS disk.
     :type storage_account_name: str
-    :param storage_redundancy_type: The VM storage type.
+    :param storage_redundancy_type: The VM storage type (Standard_LRS,
+     Standard_GRS, Standard_RAGRS). Default value: "Standard_LRS" .
     :type storage_redundancy_type: str
-    :param size: The VM Size that should be created  (e.g. Standard_A2)
+    :param size: The VM Size that should be created.  See
+     https://azure.microsoft.com/en-us/pricing/details/virtual-machines/ for
+     size info. Default value: "Standard_A2" .
     :type size: str
     :param public_ip_address_type: Use a public IP Address for the VM Nic.
-     (new, existing or none). Possible values include: 'none', 'new',
-     'existing'. Default value: "none" .
+     Possible values include: 'none', 'new', 'existing'. Default value:
+     "none" .
     :type public_ip_address_type: str
-    :param virtual_network_ip_address_prefix: The IP address prefix.
+    :param virtual_network_ip_address_prefix: The virtual network IP address
+     prefix in CIDR format.
     :type virtual_network_ip_address_prefix: str
     :param availability_set_id: Existing availability set for the VM.
     :type availability_set_id: str
@@ -110,8 +114,7 @@ class DeploymentVM(Model):
     :param public_ip_address_name: Name of public IP address to use.
     :type public_ip_address_name: str
     :param dns_name_type: Associate VMs with a public IP address to a DNS
-     name (new or none). Possible values include: 'none', 'new'. Default
-     value: "none" .
+     name. Possible values include: 'none', 'new'. Default value: "none" .
     :type dns_name_type: str
     :ivar mode: Gets or sets the deployment mode. Default value:
      "Incremental" .
@@ -146,7 +149,7 @@ class DeploymentVM(Model):
         'admin_username': {'key': 'properties.parameters.adminUsername.value', 'type': 'str'},
         'os_version': {'key': 'properties.parameters.osVersion.value', 'type': 'str'},
         'os_disk_name': {'key': 'properties.parameters.osDiskName.value', 'type': 'str'},
-        'ssh_key_path': {'key': 'properties.parameters.sshKeyPath.value', 'type': 'str'},
+        'ssh_dest_key_path': {'key': 'properties.parameters.sshDestKeyPath.value', 'type': 'str'},
         'os_offer': {'key': 'properties.parameters.osOffer.value', 'type': 'str'},
         'public_ip_address_allocation': {'key': 'properties.parameters.publicIpAddressAllocation.value', 'type': 'str'},
         'authentication_type': {'key': 'properties.parameters.authenticationType.value', 'type': 'str'},
@@ -171,7 +174,7 @@ class DeploymentVM(Model):
 
     mode = "Incremental"
 
-    def __init__(self, name, admin_username, content_version=None, storage_container_name=None, virtual_network_name=None, subnet_ip_address_prefix=None, private_ip_address_allocation=None, dns_name_for_public_ip=None, storage_account_type="new", os_disk_uri=None, virtual_network_type="new", admin_password=None, os_sku=None, subnet_name=None, os_type="Win2012R2Datacenter", os_version=None, os_disk_name=None, ssh_key_path=None, os_offer=None, public_ip_address_allocation="Dynamic", authentication_type="password", storage_account_name=None, storage_redundancy_type=None, size=None, public_ip_address_type="none", virtual_network_ip_address_prefix=None, availability_set_id=None, ssh_key_value=None, location=None, os_publisher=None, availability_set_type="none", public_ip_address_name=None, dns_name_type="none"):
+    def __init__(self, name, admin_username, content_version=None, storage_container_name=None, virtual_network_name=None, subnet_ip_address_prefix=None, private_ip_address_allocation=None, dns_name_for_public_ip=None, storage_account_type="new", os_disk_uri=None, virtual_network_type="new", admin_password=None, os_sku=None, subnet_name=None, os_type="Win2012R2Datacenter", os_version=None, os_disk_name=None, ssh_dest_key_path=None, os_offer=None, public_ip_address_allocation="Dynamic", authentication_type="password", storage_account_name=None, storage_redundancy_type="Standard_LRS", size="Standard_A2", public_ip_address_type="none", virtual_network_ip_address_prefix=None, availability_set_id=None, ssh_key_value=None, location=None, os_publisher=None, availability_set_type="none", public_ip_address_name=None, dns_name_type="none"):
         self.content_version = content_version
         self.storage_container_name = storage_container_name
         self.virtual_network_name = virtual_network_name
@@ -189,7 +192,7 @@ def __init__(self, name, admin_username, content_version=None, storage_container
         self.admin_username = admin_username
         self.os_version = os_version
         self.os_disk_name = os_disk_name
-        self.ssh_key_path = ssh_key_path
+        self.ssh_dest_key_path = ssh_dest_key_path
         self.os_offer = os_offer
         self.public_ip_address_allocation = public_ip_address_allocation
         self.authentication_type = authentication_type
diff --git a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/operations/vm_operations.py b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/operations/vm_operations.py
index 991aa1bd36f..7d18763023d 100644
--- a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/operations/vm_operations.py
+++ b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/lib/operations/vm_operations.py
@@ -32,7 +32,7 @@ def __init__(self, client, config, serializer, deserializer):
         self.config = config
 
     def create_or_update(
-            self, resource_group_name, deployment_name, name, admin_username, content_version=None, storage_container_name=None, virtual_network_name=None, subnet_ip_address_prefix=None, private_ip_address_allocation=None, dns_name_for_public_ip=None, storage_account_type="new", os_disk_uri=None, virtual_network_type="new", admin_password=None, os_sku=None, subnet_name=None, os_type="Win2012R2Datacenter", os_version=None, os_disk_name=None, ssh_key_path=None, os_offer=None, public_ip_address_allocation="Dynamic", authentication_type="password", storage_account_name=None, storage_redundancy_type=None, size=None, public_ip_address_type="none", virtual_network_ip_address_prefix=None, availability_set_id=None, ssh_key_value=None, location=None, os_publisher=None, availability_set_type="none", public_ip_address_name=None, dns_name_type="none", custom_headers={}, raw=False, **operation_config):
+            self, resource_group_name, deployment_name, name, admin_username, content_version=None, storage_container_name=None, virtual_network_name=None, subnet_ip_address_prefix=None, private_ip_address_allocation=None, dns_name_for_public_ip=None, storage_account_type="new", os_disk_uri=None, virtual_network_type="new", admin_password=None, os_sku=None, subnet_name=None, os_type="Win2012R2Datacenter", os_version=None, os_disk_name=None, ssh_dest_key_path=None, os_offer=None, public_ip_address_allocation="Dynamic", authentication_type="password", storage_account_name=None, storage_redundancy_type="Standard_LRS", size="Standard_A2", public_ip_address_type="none", virtual_network_ip_address_prefix=None, availability_set_id=None, ssh_key_value=None, location=None, os_publisher=None, availability_set_type="none", public_ip_address_name=None, dns_name_type="none", custom_headers={}, raw=False, **operation_config):
         """
         Create or update a virtual machine.
 
@@ -53,13 +53,15 @@ def create_or_update(
         :type storage_container_name: str
         :param virtual_network_name: Name of virtual network to add VM to.
         :type virtual_network_name: str
-        :param subnet_ip_address_prefix: The subnet address type.
+        :param subnet_ip_address_prefix: The subnet address prefix in CIDR
+         format.
         :type subnet_ip_address_prefix: str
-        :param private_ip_address_allocation: Dynamic of Static private IP
-         address allocation.
+        :param private_ip_address_allocation: Private IP address allocation
+         method.
         :type private_ip_address_allocation: str
         :param dns_name_for_public_ip: Globally unique DNS Name for the
-         Public IP used to access the Virtual Machine.
+         Public IP used to access the Virtual Machine.  Requires a new public
+         IP to be created by setting Public IP Address Type to New.
         :type dns_name_for_public_ip: str
         :param storage_account_type: Whether to use an existing storage
          account or create a new one. Possible values include: 'new',
@@ -87,29 +89,31 @@ def create_or_update(
         :type os_version: str
         :param os_disk_name: Name of new VM OS disk.
         :type os_disk_name: str
-        :param ssh_key_path: VM file path for SSH key.
-        :type ssh_key_path: str
+        :param ssh_dest_key_path: VM file path for SSH key.
+        :type ssh_dest_key_path: str
         :param os_offer: The OS Offer to install.
         :type os_offer: str
-        :param public_ip_address_allocation: Dynamic or Static public IP
-         address allocation. Possible values include: 'Dynamic', 'Static'
+        :param public_ip_address_allocation: Public IP address allocation
+         method. Possible values include: 'Dynamic', 'Static'
         :type public_ip_address_allocation: str
-        :param authentication_type: Authentication method: password-only or
-         add ssh-keys (Linux-only). Possible values include: 'password',
-         'sshkey'
+        :param authentication_type: Password or SSH Public Key
+         authentication. Possible values include: 'password', 'sshkey'
         :type authentication_type: str
         :param storage_account_name: Name of storage account for the VM OS
          disk.
         :type storage_account_name: str
-        :param storage_redundancy_type: The VM storage type.
+        :param storage_redundancy_type: The VM storage type (Standard_LRS,
+         Standard_GRS, Standard_RAGRS).
         :type storage_redundancy_type: str
-        :param size: The VM Size that should be created  (e.g. Standard_A2)
+        :param size: The VM Size that should be created.  See
+         https://azure.microsoft.com/en-us/pricing/details/virtual-machines/
+         for size info.
         :type size: str
         :param public_ip_address_type: Use a public IP Address for the VM
-         Nic. (new, existing or none). Possible values include: 'none',
-         'new', 'existing'
+         Nic. Possible values include: 'none', 'new', 'existing'
         :type public_ip_address_type: str
-        :param virtual_network_ip_address_prefix: The IP address prefix.
+        :param virtual_network_ip_address_prefix: The virtual network IP
+         address prefix in CIDR format.
         :type virtual_network_ip_address_prefix: str
         :param availability_set_id: Existing availability set for the VM.
         :type availability_set_id: str
@@ -125,7 +129,7 @@ def create_or_update(
         :param public_ip_address_name: Name of public IP address to use.
         :type public_ip_address_name: str
         :param dns_name_type: Associate VMs with a public IP address to a DNS
-         name (new or none). Possible values include: 'none', 'new'
+         name. Possible values include: 'none', 'new'
         :type dns_name_type: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -137,7 +141,7 @@ def create_or_update(
         :rtype: :class:`ClientRawResponse<msrest.pipeline.ClientRawResponse>`
          if raw=true
         """
-        parameters = models.DeploymentVM(content_version=content_version, storage_container_name=storage_container_name, virtual_network_name=virtual_network_name, subnet_ip_address_prefix=subnet_ip_address_prefix, private_ip_address_allocation=private_ip_address_allocation, dns_name_for_public_ip=dns_name_for_public_ip, storage_account_type=storage_account_type, os_disk_uri=os_disk_uri, name=name, virtual_network_type=virtual_network_type, admin_password=admin_password, os_sku=os_sku, subnet_name=subnet_name, os_type=os_type, admin_username=admin_username, os_version=os_version, os_disk_name=os_disk_name, ssh_key_path=ssh_key_path, os_offer=os_offer, public_ip_address_allocation=public_ip_address_allocation, authentication_type=authentication_type, storage_account_name=storage_account_name, storage_redundancy_type=storage_redundancy_type, size=size, public_ip_address_type=public_ip_address_type, virtual_network_ip_address_prefix=virtual_network_ip_address_prefix, availability_set_id=availability_set_id, ssh_key_value=ssh_key_value, location=location, os_publisher=os_publisher, availability_set_type=availability_set_type, public_ip_address_name=public_ip_address_name, dns_name_type=dns_name_type)
+        parameters = models.DeploymentVM(content_version=content_version, storage_container_name=storage_container_name, virtual_network_name=virtual_network_name, subnet_ip_address_prefix=subnet_ip_address_prefix, private_ip_address_allocation=private_ip_address_allocation, dns_name_for_public_ip=dns_name_for_public_ip, storage_account_type=storage_account_type, os_disk_uri=os_disk_uri, name=name, virtual_network_type=virtual_network_type, admin_password=admin_password, os_sku=os_sku, subnet_name=subnet_name, os_type=os_type, admin_username=admin_username, os_version=os_version, os_disk_name=os_disk_name, ssh_dest_key_path=ssh_dest_key_path, os_offer=os_offer, public_ip_address_allocation=public_ip_address_allocation, authentication_type=authentication_type, storage_account_name=storage_account_name, storage_redundancy_type=storage_redundancy_type, size=size, public_ip_address_type=public_ip_address_type, virtual_network_ip_address_prefix=virtual_network_ip_address_prefix, availability_set_id=availability_set_id, ssh_key_value=ssh_key_value, location=location, os_publisher=os_publisher, availability_set_type=availability_set_type, public_ip_address_name=public_ip_address_name, dns_name_type=dns_name_type)
 
         # Construct URL
         url = '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}'
diff --git a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/swagger_create_vm.json b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/swagger_create_vm.json
index 47cb93e372f..42fb9ebaae5 100644
--- a/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/swagger_create_vm.json
+++ b/src/command_modules/azure-cli-vm/azure/cli/command_modules/vm/mgmt/swagger_create_vm.json
@@ -245,9 +245,9 @@
           "$ref": "#/definitions/DeploymentParameter_osDiskName",
           "x-ms-client-flatten": true
         },
-        "sshKeyPath": {
+        "sshDestKeyPath": {
           "type": "object",
-          "$ref": "#/definitions/DeploymentParameter_sshKeyPath",
+          "$ref": "#/definitions/DeploymentParameter_sshDestKeyPath",
           "x-ms-client-flatten": true
         },
         "osOffer": {
@@ -336,6 +336,7 @@
         "value": {
           "type": "string",
           "description": "Name of storage container for the VM OS disk.",
+          "default": "vhds",
           "x-ms-client-name": "storageContainerName"
         }
       }
@@ -353,7 +354,8 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "The subnet address type.",
+          "description": "The subnet address prefix in CIDR format.",
+          "default": "10.0.0.0/24",
           "x-ms-client-name": "subnetIpAddressPrefix"
         }
       }
@@ -362,7 +364,12 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Dynamic of Static private IP address allocation.",
+          "description": "Private IP address allocation method.",
+          "enum": [
+            "Dynamic",
+            "Static"
+          ],
+          "default": "Dynamic",
           "x-ms-client-name": "privateIpAddressAllocation"
         }
       }
@@ -371,7 +378,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Globally unique DNS Name for the Public IP used to access the Virtual Machine.",
+          "description": "Globally unique DNS Name for the Public IP used to access the Virtual Machine.  Requires a new public IP to be created by setting Public IP Address Type to New.",
           "x-ms-client-name": "dnsNameForPublicIP"
         }
       }
@@ -454,6 +461,7 @@
         "value": {
           "type": "string",
           "description": "The OS SKU to install.",
+          "default": "2012-R2-Datacenter",
           "x-ms-client-name": "osSKU"
         }
       }
@@ -508,6 +516,7 @@
         "value": {
           "type": "string",
           "description": "The OS version to install.",
+          "default": "latest",
           "x-ms-client-name": "osVersion"
         }
       }
@@ -517,16 +526,17 @@
         "value": {
           "type": "string",
           "description": "Name of new VM OS disk.",
+          "default": "osdiskimage",
           "x-ms-client-name": "osDiskName"
         }
       }
     },
-    "DeploymentParameter_sshKeyPath": {
+    "DeploymentParameter_sshDestKeyPath": {
       "properties": {
         "value": {
           "type": "string",
           "description": "VM file path for SSH key.",
-          "x-ms-client-name": "sshKeyPath"
+          "x-ms-client-name": "sshDestKeyPath"
         }
       }
     },
@@ -535,6 +545,7 @@
         "value": {
           "type": "string",
           "description": "The OS Offer to install.",
+          "default": "WindowsServer",
           "x-ms-client-name": "osOffer"
         }
       }
@@ -543,7 +554,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Dynamic or Static public IP address allocation.",
+          "description": "Public IP address allocation method.",
           "enum": [
             "Dynamic",
             "Static"
@@ -557,7 +568,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Authentication method: password-only or add ssh-keys (Linux-only).",
+          "description": "Password or SSH Public Key authentication.",
           "enum": [
             "password",
             "sshkey"
@@ -580,7 +591,8 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "The VM storage type.",
+          "description": "The VM storage type (Standard_LRS, Standard_GRS, Standard_RAGRS).",
+          "default": "Standard_LRS",
           "x-ms-client-name": "storageRedundancyType"
         }
       }
@@ -589,7 +601,8 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "The VM Size that should be created  (e.g. Standard_A2)",
+          "description": "The VM Size that should be created.  See https://azure.microsoft.com/en-us/pricing/details/virtual-machines/ for size info.",
+          "default": "Standard_A2",
           "x-ms-client-name": "size"
         }
       }
@@ -598,7 +611,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Use a public IP Address for the VM Nic. (new, existing or none).",
+          "description": "Use a public IP Address for the VM Nic.",
           "enum": [
             "none",
             "new",
@@ -613,7 +626,8 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "The IP address prefix.",
+          "description": "The virtual network IP address prefix in CIDR format.",
+          "default": "10.0.0.0/16",
           "x-ms-client-name": "virtualNetworkIpAddressPrefix"
         }
       }
@@ -650,6 +664,7 @@
         "value": {
           "type": "string",
           "description": "The OS publisher of the OS image.",
+          "default": "MicrosoftWindowsServer",
           "x-ms-client-name": "osPublisher"
         }
       }
@@ -681,7 +696,7 @@
       "properties": {
         "value": {
           "type": "string",
-          "description": "Associate VMs with a public IP address to a DNS name (new or none).",
+          "description": "Associate VMs with a public IP address to a DNS name.",
           "enum": [
             "none",
             "new"