Skip to content

Commit 2f8cdab

Browse files
committed
Updating AFS PS changes
1 parent c1cc169 commit 2f8cdab

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -245,12 +245,12 @@ testAzureFS ConfigureBackup Completed 11/12/2018 2:15:26 P
245245

246246
## Important notice - Backup item identification for AFS backups
247247

248-
This section outlines the changes in the Backup item retrieval for AFS backups from preview to GA.
248+
This section outlines an important change in AFS backup in preparation for GA.
249249

250-
While enabling the backup for AFS, user supplies the customer friendly File share name as the entity name and a backup item is created. The backup item's 'name' is a unique identifier created by Azure Backup service. Usually the identifier involves user friendly name. But there has been a change in the way Azure services internally identify an azure file share uniquely. This means that the unique-name of the backup item for AFS backup will be a GUID and will not have any relation to the customer friendly name. In order to know the unique name of each item, just run the ```Get-AzRecoveryServicesBackupItem``` command with the relevant filters for backupManagementType and WorkloadType to get all the relevant items and then observe the name field in the returned PS object/response. It is always recommended to list items and then retrieve their unique name from 'name' field in response. Use this value to filter the items with the 'Name' parameter. Otherwise use the FriendlyName parameter to retrieve the item with it's customer friendly name/identifier.
250+
While enabling the backup for AFS, user supplies the customer friendly File share name as the entity name and a backup item is created. The backup item's 'name' is a unique identifier created by Azure Backup service. Usually the identifier involves user friendly name. But to handle the important scenario of soft-delete, where a file share can be deleted and another file-share can be created with the same name, the unique identity of Azure file share will now be an ID instead of customer friendly name. In order to know the unique identity/name of each item, just run the ```Get-AzRecoveryServicesBackupItem``` command with the relevant filters for backupManagementType and WorkloadType to get all the relevant items and then observe the name field in the returned PS object/response. It is always recommended to list items and then retrieve their unique name from 'name' field in response. Use this value to filter the items with the 'Name' parameter. Otherwise use the FriendlyName parameter to retrieve the item with it's customer friendly name/identifier.
251251

252252
> [!WARNING]
253-
> Make sure the PS version is upgraded to the minimum version for 'Az.RecoveryServices 2.6.0' for AFS backups. With this version, the 'friendlyName' filter is available for ```Get-AzRecoveryServicesBackupItem``` command. Pass the azure file share name to friendlyName parameter. If you pass the azure file share name to the 'Name' parameter, this version throws a warning to pass this friendly name to the friendly name parameter. Not installing this minimum version might result in failure of existing scripts. Install the minimum version of PS with the following command.
253+
> Make sure the PS version is upgraded to the minimum version for 'Az.RecoveryServices 2.6.0' for AFS backups. With this version, the 'friendlyName' filter is available for ```Get-AzRecoveryServicesBackupItem``` command. Pass the Azure File Share name to friendlyName parameter. If you pass the Azure File Share name to the 'Name' parameter, this version throws a warning to pass this friendly name to the friendly name parameter. Not installing this minimum version might result in failure of existing scripts. Install the minimum version of PS with the following command.
254254
255255
```powershell
256256
Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0

0 commit comments

Comments
 (0)