Merge pull request #112521 from pvrk/Jan2020Local

Updating PS CLI docs regarding instant restore

Author: PRMerger20

articles/backup/backup-azure-vms-automation.md

@@ -476,8 +476,8 @@ $restorejob
 
 Provide an additional parameter **TargetResourceGroupName** to specify the RG to which managed disks will be restored.
 
-> [!NOTE]
-> It is strongly recommended to use the **TargetResourceGroupName** parameter for restoring managed disks since it results in significant performance improvements. Also, from Azure Powershell Az module 1.0 onwards, this parameter is mandatory in case of a restore with managed disks
+> [!IMPORTANT]
+> It is strongly recommended to use the **TargetResourceGroupName** parameter for restoring managed disks since it results in significant performance improvements. If this parameter is not given, then customers cannot benefit from the instant restore functionality and the restore operation will be slower in comparison. If the purpose is to restore managed disks as unmanaged disks, then do not provide this parameter and make the intention clear by providing the -RestoreAsUnmanagedDisks parameter. The -RestoreAsUnmanagedDisks parameter is available from Az PS 3.7.0 onwards. In future versions, it will be mandatory to provide either of these parameters for the right restore experience
 >
 >
 

articles/backup/tutorial-restore-disk.md

@@ -83,7 +83,19 @@ If the backed up VM has managed disks and if the intent is to restore managed di
     ```
 
 > [!WARNING]
-> If target-resource-group is not provided then the managed disks will be restored as unmanaged disks to the given storage account. This will have significant consequences to the restore time since the time taken to restore the disks entirely depends on the given storage account.
+> If target-resource-group is not provided then the managed disks will be restored as unmanaged disks to the given storage account. This will have significant consequences to the restore time since the time taken to restore the disks entirely depends on the given storage account. Customers will get the benefit of instant restore only when the target-resource-group parameter is given. If the intention is to restore managed disks as unmanaged then do not provide the target-resource-group parameter and instead provide the parameter restore-as-unmanaged-disk parameter as shown below. This parameter is available from az 3.4.0 onwards.
+
+    ```azurecli-interactive
+    az backup restore restore-disks \
+        --resource-group myResourceGroup \
+        --vault-name myRecoveryServicesVault \
+        --container-name myVM \
+        --item-name myVM \
+        --storage-account mystorageaccount \
+        --rp-name myRecoveryPointName
+        --restore-as-unmanaged-disk
+    ```
+This will restore managed disks as unmanaged disks to the given storage account and will not be leveraging the 'instant' restore functionality. In future versions of CLI, it will be mandatory to provide either the target-resource-group parameter or 'restore-as-unmanaged-disk' parameter.
 
 ### Unmanaged disks restore