Merge pull request #292372 from AbhishekMallick-MS/Dec-24-2024-Blob

Blob backup - Update policy PS command updates

Author: v-ccolin

articles/backup/backup-blobs-storage-account-ps.md

@@ -3,7 +3,7 @@ title: Back up Azure blobs within a storage account using Azure PowerShell
 description: Learn how to back up all Azure blobs within a storage account using Azure PowerShell.
 ms.topic: how-to
 ms.custom: devx-track-azurepowershell
-ms.date: 11/27/2024
+ms.date: 12/27/2024
 author: AbhishekMallick-MS
 ms.author: v-abhmallick
 ---
@@ -156,7 +156,96 @@ To update the backup instance, run the following cmdlets:
 
 1. Change the policy used for backing up the Azure Blobs by using the [Update-AzDataProtectionBackupInstance](/powershell/module/az.dataprotection/update-azdataprotectionbackupinstance?view=azps-13.0.0&preserve-view=true). Specify the relevant backup item and the new backup policy.
 
+1. Update the policy or the new containers to existing backup items.
 
-## Next steps
+   1. Create the storage account context by using the `New-AzStorageContext` cmdlet. Provide the `-UseConnectedAccount` parameter so that data operations are performed using your Microsoft Entra credentials. Learn more [about the storage account commands](/azure/storage/blobs/blob-containers-powershell#list-containers). 
+
+      ```azurepowershell
+      Create a context object using Azure AD credentials
+      $ctx = New-AzStorageContext -StorageAccountName xxx -UseConnectedAccount 
+
+      ```
+
+   1. Retrieve the storage containers using the `Get-AzStorageContainer` cmdlet. To retrieve a single container, provide the `-Name` parameter. To return a list of containers that begins with a given character string, specify a value for the `-Prefix` parameter.
+
+   The following example retrieves both an individual container and a list of container resources:
+
+      ```azurepowershell
+
+
+      # Create variables
+      $containerName  = "individual-container"
+      $prefixName     = "loop-"
+
+      # Approach 1: Retrieve an individual container
+      Get-AzStorageContainer -Name $containerName -Context $ctx
+      Write-Host
+
+      # Approach 2: Retrieve a list of containers
+      $targetContainers = Get-AzStorageContainer -Context $ctx | Where-Object { $_.Name -match "cont" } 
+      ```
+
+      The result provides the URI of the blob endpoint and lists the containers retrieved by name and prefix:
+
+      ```
+      Storage Account Name: demostorageaccount
+      
+      Name                 PublicAccess         LastModified                   IsDeleted  VersionId        
+      ----                 ------------         ------------                   ---------  ---------        
+      individual-container                      11/2/2021 5:52:08 PM +00:00                                
+      
+      loop-container1                           11/2/2021 12:22:00 AM +00:00                               
+      loop-container2                           11/2/2021 12:22:00 AM +00:00                               
+
+      loop-container1                           11/2/2021 12:22:00 AM +00:00                               
+      loop-container2                           11/2/2021 12:22:00 AM +00:00
+      loop-container3                           11/2/2021 12:22:00 AM +00:00   True       01D7E7129FDBD7D4
+      loop-container4                           11/2/2021 12:22:00 AM +00:00   True       01D7E8A5EF01C787 
+      ```
+
+   1. Fetch the backup instance that needs to be updated.
+
+         ```azurepowershell
+         C:\Users\dapatil> $instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription "Demosub" -ResourceGroup Demo-BCDR-RG -Vault BCDR-BV-EastUS -DatasourceType AzureBlob
+         PS C:\Users\dapatil> $instance
+                        Output
+         Name                                                                     BackupInstanceName
+         ----                                                                     ------------------
+         blobsa-blobsa-c7325e08-980d-43b2-863f-68feee4fd03c               blobsa-blobsa-c7325e08-980d-43b2-863f-68feee4fd03c
+         blobsavaulted-blobsavaulted-40c36519-f422-45aa-bbeb-3f0eedb440c7 blobsavaulted-blobsavaulted-40c36519-f422-45aa-bbeb-3f0eedb440c7
+         testdpp-testdpp-ff4254dd-7a70-437b-9a10-8c0d2223d037                     testdpp-testdpp-ff4254dd-7a70-437b-9a10-8c0d2223d037
+
+         ```
+
+   1. Fetch the backup policy with the name of vaulted-policy that you want to update in Backup Instance. You can also fetch the new policy that needs to be updated in Backup Instance.
+
+         ```azurepowershell
+         $updatePolicy = Get-AzDataProtectionBackupPolicy -SubscriptionId "Demosub" -VaultName BCDR-BV-EastUS -ResourceGroupName Demo-BCDR-RG -name continer-1
+         ```
+
+   1. Update the backup instance with new list of container (the existing backed up containers & new containers).       
+
+         ```azurepowershell
+         PS C:\Users\dapatil> $updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName Daya-BCDR-RG -VaultName DPBCDR-BV-EastUS -BackupInstanceName $instance[0].Name -SubscriptionId "ef4ab5a7-c2c0-4304-af80-af49f48af3d1"  -PolicyId $updatePolicy.id -VaultedBackupContainer $targetContainers.name
+         
+         
+         PS C:\Users\dapatil> $updateBI.Property.PolicyInfo.PolicyId
+         /subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/Daya-BCDR-RG/providers/Microsoft.DataProtection/backupVaults/DPBCDR-BV-EastUS/backupPolicies/continerdeltest-1
+         PS C:\Users\dapatil> $updateBI.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList
+         cont-01
+         cont-02
+         cont-03
+         cont-04
+         cont-05
+         cont-06
+         cont-07
+         cont-08
+         cont-09
+         cont-10
+         cont-11
+         ```
+
+
+##  Next steps
 
 [Restore Azure blobs using Azure PowerShell](restore-blobs-storage-account-ps.md)