{vm-repair} Overhaul VM Repair examples

src/vm-repair/HISTORY.rst

@@ -5,6 +5,7 @@ Release History
 2.0.1
 ++++++
 Fixed 2 Unbound variable bugs in `vm repair create` and improved the code documentation.  
+Updated parameter descriptions and examples for `az vm repair create`.
 
 2.0.0
 ++++++

src/vm-repair/azext_vm_repair/_help.py

@@ -7,9 +7,9 @@
 
 helps['vm repair'] = """
     type: group
-    short-summary: Auto repair commands to fix VMs.
+    short-summary: Setup repair VMs with copied source OS Disk to resolve issues.
     long-summary: |
-        VM repair command will enable Azure users to self-repair non-bootable VMs by copying the source VM's OS disk and attaching it to a newly created repair VM.
+        When your VM is non-bootable, VM Repair enables users to setup new repair VMs and copy over the source VM's OS Disk and attach it as a data disk. Then the user can run their own scripts or use [pre-built](https://github.com/Azure/repair-script-library) ones to fix the disk.
 """
 
 helps['vm repair create'] = """
@@ -25,6 +25,18 @@
         - name: Create a repair VM of a specific distro or a specific URN could also be provided
           text: >
             az vm repair create -g MyResourceGroup -n myVM --distro 'rhel7|sles12|ubuntu20|centos6|oracle8|sles15'
+        - name: Create a repair VM with a Private IP address without any pop up asking for confirmation.
+          text: >
+            az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password>
+        - name: Create a repair VM with a Public IP address without any user input.
+          text: >
+            az vm repair create -g MyResourceGroup -n myVM --associate-public-ip --yes --repair-username <username> --repair-password <password>
+        - name: Create a repair VM with Standard Security type.
+          text: >
+            az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password> --disable-trusted-launch
+        - name: Create a repair VM from a source VM with an encrypted disk. The repair VM is created with the data disk unencrypted and accessible.
+          text: >
+            az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password> --unlock-encrypted-vm --encrypt-recovery-key <key>
 """
 
 helps['vm repair restore'] = """

src/vm-repair/azext_vm_repair/_params.py

@@ -29,7 +29,7 @@ def load_arguments(self, _):
         c.argument('copy_disk_name', help='Name of OS disk copy.')
         c.argument('repair_group_name', help='Name for new or existing resource group that will contain repair VM.')
         c.argument('unlock_encrypted_vm', help='Option to auto-unlock encrypted VMs using current subscription auth.')
-        c.argument('encrypt_recovery_key', help='Option to auto-unlock encrypted VMs using provided recovery password.')
+        c.argument('encrypt_recovery_key', help='Option to auto-unlock encrypted VMs using provided recovery password. The \'unlock_encrypted_vm\' parameter must be used to use this parameter.')
         c.argument('enable_nested', help='enable nested hyperv.')
         c.argument('associate_public_ip', help='Option to create a repair vm with a public ip. If this parameter is not used, a private ip will be made.')
         c.argument('distro', help='Option to create repair vm from a specific linux distro (rhel7|rhel8|sles12|sles15|ubuntu20|centos7|centos8|oracle7)')