Skip to content

Commit 98769e0

Browse files
committed
Updating PS CLI docs regarding instant restore
1 parent 75d37e4 commit 98769e0

File tree

2 files changed

+15
-3
lines changed

2 files changed

+15
-3
lines changed

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -476,8 +476,8 @@ $restorejob
476476
477477
Provide an additional parameter **TargetResourceGroupName** to specify the RG to which managed disks will be restored.
478478

479-
> [!NOTE]
480-
> 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
479+
> [!IMPORTANT]
480+
> 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
481481
>
482482
>
483483

articles/backup/tutorial-restore-disk.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,19 @@ If the backed up VM has managed disks and if the intent is to restore managed di
8383
```
8484
8585
> [!WARNING]
86-
> 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.
86+
> 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.
87+
88+
```azurecli-interactive
89+
az backup restore restore-disks \
90+
--resource-group myResourceGroup \
91+
--vault-name myRecoveryServicesVault \
92+
--container-name myVM \
93+
--item-name myVM \
94+
--storage-account mystorageaccount \
95+
--rp-name myRecoveryPointName
96+
--restore-as-unmanaged-disk
97+
```
98+
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.
8799
88100
### Unmanaged disks restore
89101

0 commit comments

Comments
 (0)