PwShell Howto

Author: Ankita Dutta

articles/site-recovery/azure-to-azure-tutorial-enable-replication-shared-disk.md

@@ -181,6 +181,25 @@ Write-Output $TempASRJob.State
 $PrimaryProtContainer = Get-AzRecoveryServicesAsrProtectionContainer -Fabric $PrimaryFabric -Name "A2AEastUSProtectionContainer"
 ```
 
+### Create a Site Recovery protection container in the recovery fabric
+
+```powershell
+#Create a Protection container in the recovery Azure region (within the Recovery fabric)
+$TempASRJob = New-AzRecoveryServicesAsrProtectionContainer -InputObject $RecoveryFabric -Name "A2AWestUSProtectionContainer"
+
+#Track Job status to check for completion
+while (($TempASRJob.State -eq "InProgress") -or ($TempASRJob.State -eq "NotStarted")){
+        sleep 10;
+        $TempASRJob = Get-AzRecoveryServicesAsrJob -Job $TempASRJob
+}
+
+#Check if the Job completed successfully. The updated job state of a successfully completed job should be "Succeeded"
+
+Write-Output $TempASRJob.State
+
+$RecoveryProtContainer = Get-AzRecoveryServicesAsrProtectionContainer -Fabric $RecoveryFabric -Name "A2AWestUSProtectionContainer"
+```
+
 #### Fabric and container creation when enabling zone to zone replication
 
 When enabling zone to zone replication, only one fabric will be created. But there will be two containers. Assuming that the region is West Europe, use following commands to get the primary and protection containers -
@@ -342,9 +361,277 @@ A network mapping maps virtual networks in the primary region to virtual network
     #Check if the Job completed successfully. The updated job state of a successfully completed job should be "Succeeded"
     Write-Output $TempASRJob.State
 
+## Create a Site Recovery protection cluster 
+
+The protection cluster is a container used to group replicated items that are part of a shared disk cluster. 
+
+```powershell
+$clusterjob = New-AzRecoveryServicesAsrReplicationProtectionCluster -AzureToAzure -Name $clusterName -ProtectionContainerMapping $forwardpcm 
+```
+
+#### Get by name 
+
+```powershell
+$clusters = Get-AzRecoveryServicesAsrReplicationProtectionCluster -ProtectionContainer $pc -Name "3nodecluster" 
+```
+
+ #### List protection clusters in vault 
+
+```powershell
+Get-AzRecoveryServicesAsrReplicationProtectionCluster 
+```
+
+
+#### List protection clusters in protection container 
+
+```Get-AzRecoveryServicesAsrReplicationProtectionCluster -Name $clusterName -ProtectionContainer $pc```
+
+## 
+
+Replicate the Azure virtual machines with managed shared disks when disk details are unavailable.  
+
+ 
+
+$EnableJob1 = New-AzRecoveryServicesAsrReplicationProtectedItem -AzureToAzure -Name $rpiName1 -ReplicationProtectionCluster $cluster ` 
+
+-AzureVmId $vmId1 -ProtectionContainerMapping $forwardpcm -RecoveryResourceGroupId $rgId -RecoveryAvailabilitySetId $avset ` 
+
+-RecoveryProximityPlacementGroupId $ppg -RecoveryAzureNetworkId $networkId -LogStorageAccountId $storageId 
+
+ 
+
+Replicate the Azure virtual machines with managed shared disks when disk details are available. 
+
+ 
+
+$disk1 = New-AzRecoveryServicesAsrAzureToAzureDiskReplicationConfig -ManagedDisk -LogStorageAccountId $storageId ` 
+
+    -DiskId $vhdId1 -RecoveryResourceGroupId  $rgId -RecoveryReplicaDiskAccountType  $RecoveryReplicaDiskAccountType ` 
+
+    -RecoveryTargetDiskAccountType $RecoveryTargetDiskAccountType 
+
+$disk2 = New-AzRecoveryServicesAsrAzureToAzureDiskReplicationConfig -ManagedDisk -LogStorageAccountId $storageId ` 
+
+    -DiskId $vhdId2 -RecoveryResourceGroupId  $rgId -RecoveryReplicaDiskAccountType  $RecoveryReplicaDiskAccountType ` 
+
+    -RecoveryTargetDiskAccountType $RecoveryTargetDiskAccountType 
+
+$disks = @() 
+
+$disks += $disk1 
+
+$disks += $disk2 
+
+ 
+
+$EnableJob2 = New-AzRecoveryServicesAsrReplicationProtectedItem -AzureToAzure -Name $rpiName2 ` 
+
+-AzureToAzureDiskReplicationConfiguration $disks -ReplicationProtectionCluster $cluster -AzureVmId $vmId2 ` 
+
+-ProtectionContainerMapping $forwardpcm -RecoveryResourceGroupId $rgId -RecoveryAvailabilitySetId $avset ` 
+
+-RecoveryProximityPlacementGroupId $ppg -RecoveryAzureNetworkId $networkId 
+
+ 
+
+The AzureToAzureDiskReplicationConfiguration should contain both the normal disks and shared disk information. 
+
+ 
+
+Example: Enabling protection for 2 VMs in a WSFC cluster with 1 shared disk and are part of Avset and PPG 
+
+ 
+
+$RecoveryRG = Get-AzResourceGroup -Name "a2ademorecoveryrg" -Location "West US 2" 
+
+$Avset = "/subscriptions/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ClusterRG-asr/providers/Microsoft.Compute/availabilitySets/SDGQL-AS-asr" 
+
+$Ppg = "/subscriptions/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ClusterRG-asr/providers/Microsoft.Compute/proximityPlacementGroups/sdgql-ppg-asr" 
+
+$NetworkId = "/subscriptions/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ClusterRG-asr/providers/Microsoft.Network/virtualNetworks/adVNET-asr" 
+
+     
+
+$EnableJob1 = New-AzRecoveryServicesAsrReplicationProtectedItem -AzureToAzure -Name (New-Guid).Guid -ReplicationProtectionCluster $cluster ` 
+
+-AzureVmId $VM1.Id -ProtectionContainerMapping $EusToWusPCMapping -RecoveryResourceGroupId $RecoveryRG.ResourceId -RecoveryAvailabilitySetId $Avset ` 
+
+-RecoveryProximityPlacementGroupId $Ppg -RecoveryAzureNetworkId $NetworkId -LogStorageAccountId $EastUSCacheStorageAccount.Id 
+
+ 
+
+#OsDisk 
+
+$OSdiskId = $vm2.StorageProfile.OsDisk.ManagedDisk.Id 
+
+$RecoveryOSDiskAccountType = $vm2.StorageProfile.OsDisk.ManagedDisk.StorageAccountType 
+
+$RecoveryReplicaDiskAccountType = $vm2.StorageProfile.OsDisk.ManagedDisk.StorageAccountType 
+
+ 
+
+$OSDiskReplicationConfig = New-AzRecoveryServicesAsrAzureToAzureDiskReplicationConfig -ManagedDisk -LogStorageAccountId $EastUSCacheStorageAccount.Id ` 
+
+         -DiskId $OSdiskId -RecoveryResourceGroupId  $RecoveryRG.ResourceId -RecoveryReplicaDiskAccountType  $RecoveryReplicaDiskAccountType ` 
+
+         -RecoveryTargetDiskAccountType $RecoveryOSDiskAccountType 
+
+ 
+
+# Data disk 
+
+$datadiskId1 = $vm2.StorageProfile.DataDisks[0].ManagedDisk.Id 
+
+$RecoveryReplicaDiskAccountType = $vm2.StorageProfile.DataDisks[0].ManagedDisk.StorageAccountType 
+
+$RecoveryTargetDiskAccountType = $vm2.StorageProfile.DataDisks[0].ManagedDisk.StorageAccountType 
+
+ 
+
+$DataDisk1ReplicationConfig  = New-AzRecoveryServicesAsrAzureToAzureDiskReplicationConfig -ManagedDisk -LogStorageAccountId $EastUSCacheStorageAccount.Id ` 
+
+         -DiskId $datadiskId1 -RecoveryResourceGroupId $RecoveryRG.ResourceId -RecoveryReplicaDiskAccountType $RecoveryReplicaDiskAccountType ` 
+
+         -RecoveryTargetDiskAccountType $RecoveryTargetDiskAccountType 
+
+ 
+
+#Create a list of disk replication configuration objects for the disks of the virtual machine that are to be replicated. 
+
+$diskconfigs = @() 
+
+$diskconfigs += $OSDiskReplicationConfig, $DataDisk1ReplicationConfig 
+
+ 
+
+$EnableJob2 = New-AzRecoveryServicesAsrReplicationProtectedItem -AzureToAzure -Name (New-Guid).Guid ` 
+
+-AzureToAzureDiskReplicationConfiguration $diskconfigs-ReplicationProtectionCluster $cluster -AzureVmId $VM2.Id ` 
+
+-ProtectionContainerMapping $EusToWusPCMapping -RecoveryResourceGroupId $RecoveryRG.ResourceId -RecoveryAvailabilitySetId $Avset ` 
+
+-RecoveryProximityPlacementGroupId $Ppg -RecoveryAzureNetworkId $NetworkId 
+
+ 
+
+ 
+
+Recovery points 
+
+List 
+
+Get-AzRecoveryServicesAsrClusterRecoveryPoint -ReplicationProtectionCluster $cluster 
+
+ 
+
+Get 
+
+Get-AzRecoveryServicesAsrClusterRecoveryPoint -ReplicationProtectionCluster $cluster -Name "xxxxxxxxxxxxxxxxxxxxxxxxxxxx" 
+
+ 
+
+ 
+
+Test Failover 
+
+Test the fail over of the cluster to a specific recovery point. 
+
+$tfoJob = Start-AzRecoveryServicesAsrClusterTestFailoverJob -ReplicationProtectionCluster $protectionCluster -Direction PrimaryToRecovery -AzureVMNetworkId "/subscriptions/xxxxxxxxx/resourceGroups/ClusterRG-asr/providers/Microsoft.Network/virtualNetworks/adVNET-asr" -LatestProcessedRecoveryPoint 
+
+ 
+
+ 
+
+Test Failover Cleanup 
+
+Cleanup the test failover after completion of testing 
+
+Start-AzRecoveryServicesAsrClusterTestFailoverCleanupJob -ReplicationProtectionCluster $protectionCluster  
+
+ 
+
+Failover 
+
+Fail over the cluster to a specific recovery point. 
+
+$rpi1 = Get-ASRReplicationProtectedItem -ProtectionContainer $protectionContainer -FriendlyName "sdgql1" 
+
+    $rpi2 = Get-ASRReplicationProtectedItem -ProtectionContainer $protectionContainer -FriendlyName "sdgql2" 
+
+    $nodeRecoveryPoint1 = Get-ASRRecoveryPoint -ReplicationProtectedItem $rpi1 
+
+    $nodeRecoveryPoint2 = Get-ASRRecoveryPoint -ReplicationProtectedItem $rpi2 
+
+  
+
+    $nodeRecoveryPoints = @($nodeRecoveryPoint1[-1].ID, $nodeRecoveryPoint2[-1].ID) 
+
+    $clusterRecoveryPoints = Get-AzRecoveryServicesAsrClusterRecoveryPoint -ReplicationProtectionCluster $protectionCluster 
+
+    
+
+    $ufoJob = Start-AzRecoveryServicesAsrClusterUnplannedFailoverJob -ReplicationProtectionCluster $protectionCluster -Direction PrimaryToRecovery -ClusterRecoveryPoint $clusterRecoveryPoints[-1] -ListNodeRecoveryPoint $nodeRecoveryPoints 
+
+ 
+
+Change Pit 
+
+$rpi1 = Get-ASRReplicationProtectedItem -ProtectionContainer $protectionContainer -FriendlyName "sdgql1" 
+
+    $rpi2 = Get-ASRReplicationProtectedItem -ProtectionContainer $protectionContainer -FriendlyName "sdgql2" 
+
+    $nodeRecoveryPoint1 = Get-ASRRecoveryPoint -ReplicationProtectedItem $rpi1 
+
+    $nodeRecoveryPoint2 = Get-ASRRecoveryPoint -ReplicationProtectedItem $rpi2 
+
+  
+
+    $nodeRecoveryPoints = @($nodeRecoveryPoint1[-1].ID, $nodeRecoveryPoint2[-1].ID) 
+
+    $clusterRecoveryPoints = Get-AzRecoveryServicesAsrClusterRecoveryPoint -ReplicationProtectionCluster $protectionCluster 
+
+   $changePitJob = Start-AzRecoveryServicesAsrApplyClusterRecoveryPoint -ReplicationProtectionCluster $protectionCluster -ClusterRecoveryPoint $clusterRecoveryPoints[-1] -ListNodeRecoveryPoint $nodeRecoveryPoints 
+
+ 
+
+Commit Failover 
+$CommitFailoverJob = Start-AzRecoveryServicesAsrClusterCommitFailoverJob -ReplicationProtectionCluster $protectionCluster    
+
+ 
+
+Reprotect  
+
+After failover, protect the Cluster in the new source region back and failover to the new target region. 
+
+$storage = "/subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/vijami-alertrg/providers/Microsoft.Storage/storageAccounts/yerp1nvijamitestasrcache" 
+
+    $ppg = "/subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/ClusterRG-Vijami-1003165924/providers/Microsoft.Compute/proximityPlacementGroups/sdgql-ppg" 
+
+    $avset = "/subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/ClusterRG-Vijami-1003165924/providers/Microsoft.Compute/availabilitySets/SDGQL-AS" 
+
+    $rgId = "/subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/ClusterRG-Vijami-1003165924" 
+
+  
+
+    # Without protected item details 
+
+    $recoveryFabricName = "asr-a2a-default-westus" 
+
+    $recoveryFabric = Get-AzRecoveryServicesAsrFabric -Name $recoveryFabricName 
+
+    $recoverypc = Get-AzRecoveryServicesAsrProtectionContainer -Fabric $recoveryFabric 
+
+    $recoverypcm = Get-AzRecoveryServicesAsrProtectionContainerMapping -ProtectionContainer $recoverypc -Name "westus-eastus2-24-hour-retention-policy" 
+
+    $ReprotectJob = Update-AzRecoveryServicesAsrClusterProtectionDirection -AzureToAzure -ReplicationProtectionCluster $cluster ` 
+
+    -RecoveryProximityPlacementGroupId $ppg -RecoveryAvailabilitySetId $avset ` 
 
+    -RecoveryResourceGroupId $rgId -LogStorageAccountId $storage -ProtectionContainerMapping $recoverypcm 
 
+ 
 
+After reprotection is complete, you can fail over in the reverse direction, West US to East US, and fail back to source region using Failover.