Restore-AzRecoveryServicesBackupItem
Restaura os dados e a configuração de um item de backup no ponto de recuperação especificado. Os parâmetros necessários variam de acordo com o tipo de item de backup. O mesmo comando é usado para restaurar máquinas virtuais do Azure, bancos de dados em execução nas máquinas virtuais do Azure e compartilhamentos de arquivos do Azure também.
Sintaxe
Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
[-StorageAccountName] <String>
[-StorageAccountResourceGroupName] <String>
[-RestoreOnlyOSDisk]
[-RestoreDiskList <String[]>]
[-DiskEncryptionSetId <String>]
[-RestoreToSecondaryRegion]
[-TargetZoneNumber <Int32>]
[-RehydratePriority <String>]
[-UseSystemAssignedIdentity]
[-UserAssignedIdentityId <String>]
[-DiskAccessOption <TargetDiskNetworkAccessOption>]
[-TargetDiskAccessId <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
-ResolveConflict <RestoreFSResolveConflictOption>
[-SourceFilePath <String>]
[-SourceFileType <SourceFileType>]
[-TargetStorageAccountName <String>]
[-TargetFileShareName <String>]
[-TargetFolder <String>]
[-MultipleSourceFilePath <String[]>]
[-RestoreToSecondaryRegion]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
[-StorageAccountName] <String>
[-StorageAccountResourceGroupName] <String>
[-RestoreOnlyOSDisk]
[-RestoreDiskList <String[]>]
[-RestoreAsUnmanagedDisks]
[-RestoreToSecondaryRegion]
[-RehydratePriority <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
[-StorageAccountName] <String>
[-StorageAccountResourceGroupName] <String>
[-TargetResourceGroupName] <String>
[-RestoreOnlyOSDisk]
[-RestoreDiskList <String[]>]
[-DiskEncryptionSetId <String>]
[-RestoreToSecondaryRegion]
[-TargetZoneNumber <Int32>]
[-RehydratePriority <String>]
[-UseSystemAssignedIdentity]
[-UserAssignedIdentityId <String>]
[-TargetVMName <String>]
[-TargetVNetName <String>]
[-TargetVNetResourceGroup <String>]
[-TargetSubnetName <String>]
[-TargetSubscriptionId <String>]
[-RestoreToEdgeZone]
[-DiskAccessOption <TargetDiskNetworkAccessOption>]
[-TargetDiskAccessId <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
[-StorageAccountName] <String>
[-StorageAccountResourceGroupName] <String>
[-UseOriginalStorageAccount]
[-RestoreOnlyOSDisk]
[-RestoreDiskList <String[]>]
[-RestoreToSecondaryRegion]
[-RehydratePriority <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-RecoveryPoint] <RecoveryPointBase>
[-StorageAccountName] <String>
[-StorageAccountResourceGroupName] <String>
[-TargetResourceGroupName] <String>
[-UseOriginalStorageAccount]
[-RestoreOnlyOSDisk]
[-RestoreDiskList <String[]>]
[-RestoreToSecondaryRegion]
[-RestoreAsManagedDisk]
[-RehydratePriority <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Restore-AzRecoveryServicesBackupItem
[-VaultLocation <String>]
[-WLRecoveryConfig] <RecoveryConfigBase>
[-RestoreToSecondaryRegion]
[-RehydratePriority <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-RehydrateDuration <String>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Restore-AzRecoveryServicesBackupItem restaura os dados e a configuração de um item do Backup do Azure para um ponto de recuperação especificado.
Para de backup de VM do Azure
Você pode fazer backup de máquinas virtuais do Azure e restaurar discos (gerenciados e não gerenciados) usando este comando. A operação de restauração não restaura a máquina virtual completa. Se esta for uma VM de disco gerenciado, um grupo de recursos de destino deve ser especificado onde os discos restaurados são mantidos. Quando o grupo de recursos de destino é especificado, se os instantâneos estiverem presentes no grupo de recursos especificado na política de backup, a operação de restauração será instantânea e os discos serão criados a partir de instantâneos locais e mantidos no grupo de recursos de destino. Há também uma opção para restaurá-los como discos não gerenciados, mas isso aproveitará os dados presentes no cofre de serviços de recuperação do Azure e, portanto, será muito mais lento. A configuração da VM e o modelo de implantação que pode ser usado para criar VM a partir dos discos restaurados serão baixados para a conta de armazenamento especificada. Se esta for uma VM de disco não gerenciada, os instantâneos estarão presentes na conta de armazenamento original do disco e/ou no cofre dos serviços de recuperação. Se o usuário der uma opção para usar a conta de armazenamento original para restaurar, a restauração instantânea poderá ser fornecida. Caso contrário, os dados serão buscados no cofre dos serviços de Recuperação do Azure e os discos serão criados na conta de armazenamento especificada, juntamente com a configuração da VM e o modelo de implantação.
Importante
Por padrão, o backup da VM do Azure faz backup de todos os discos. Você pode fazer backup seletivamente de discos relevantes usando os parâmetros exclusionList ou InclusionList durante Enable-Backup. A opção de restaurar discos seletivamente só estará disponível se alguém tiver feito backup seletivamente deles.
Consulte os diferentes conjuntos de parâmetros possíveis e o texto dos parâmetros para obter mais informações.
Observação
Se -VaultId parâmetro for usado, então -VaultLocation parâmetro também deve ser usado.
Para de backup de compartilhamento de arquivos do Azure
Você pode restaurar um compartilhamento de arquivos inteiro ou arquivos / pastas específicos / múltiplos no compartilhamento. Você pode restaurar para o local original ou para um local alternativo.
para cargas de trabalho do Azure
Você pode restaurar DBs SQL em VMs do Azure
Exemplos
Exemplo 1: Restaurar os discos de uma VM do Azure de disco gerenciado de backup a partir de um determinado ponto de recuperação
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre dos Serviços de Recuperação e o armazena em $vault variável. O segundo comando obtém o item Backup do tipo AzureVM, do nome "V2VM", e o armazena na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, armazena-a na variável $StartDate. O quarto comando obtém a data atual e, em seguida, armazena-a na variável $EndDate. O quinto comando obtém uma lista de pontos de recuperação para o item de backup específico filtrado por $StartDate e $EndDate. O último comando restaura todos os discos para o grupo de recursos de destino Target_RG e, em seguida, fornece as informações de configuração da VM e o modelo de implantação na conta de armazenamento DestAccount no grupo de recursos DestRG.
Exemplo 2: Restaurar uma VM do AzureVM Gerenciada de um determinado ponto de recuperação para o local original/alternativo
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$AlternateLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -TargetVMName "TagetVirtualMachineName" -TargetVNetName "Target_VNet" -TargetVNetResourceGroup "Target_VNet_RG" -TargetSubnetName "subnetName" -VaultId $vault.ID -VaultLocation $vault.Location
$OriginalLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre dos Serviços de Recuperação e o armazena em $vault variável. O segundo comando obtém o item Backup do tipo AzureVM, do nome "V2VM", e o armazena na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, armazena-a na variável $StartDate. O quarto comando obtém a data atual e, em seguida, armazena-a na variável $EndDate. O quinto comando obtém uma lista de pontos de recuperação para o item de backup específico filtrado por $StartDate e $EndDate. O sexto comando dispara uma Restauração de Local Alternativo (ALR) para criar uma nova VM em Target_RG grupo de recursos de acordo com as entradas especificadas pelos parâmetros TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. Como alternativa, se um usuário quiser executar uma restauração in-loco para a VM originalmente copiada no local original, isso pode ser feito com o último comando. Evite usando os parâmetros TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName para executar o OLR (Original Location Restore).
Exemplo 3: Restaurar discos especificados de uma VM do Azure de disco gerenciado de backup de um determinado ponto de recuperação
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$restoreDiskLUNs = ("0", "1")
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -RestoreDiskList $restoreDiskLUNs -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre dos Serviços de Recuperação e o armazena em $vault variável. O segundo comando obtém o item Backup do tipo AzureVM, do nome "V2VM", e o armazena na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, armazena-a na variável $StartDate. O quarto comando obtém a data atual e, em seguida, armazena-a na variável $EndDate. O quinto comando obtém uma lista de pontos de recuperação para o item de backup específico filtrado por $StartDate e $EndDate. O sexto comando armazena a lista de discos a serem restaurados na variável restoreDiskLUN. O último comando restaura os discos fornecidos, dos LUNs especificados, para o grupo de recursos de destino Target_RG e, em seguida, fornece as informações de configuração da VM e o modelo de implantação na conta de armazenamento DestAccount no grupo de recursos DestRG.
Exemplo 4: Restaurar discos de uma VM gerenciada como discos não gerenciados
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem[0] -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -RestoreAsUnmanagedDisks -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre RecoveryServices e o armazena em $vault variável. O segundo comando obtém o item Backup e, em seguida, armazena-o na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, armazena-a na variável $StartDate. O quarto comando obtém a data atual e, em seguida, armazena-a na variável $EndDate. O quinto comando obtém uma lista de pontos de recuperação para o item de backup específico filtrado por $StartDate e $EndDate. O sexto comando restaura os discos como discos não gerenciados.
Exemplo 5: Restaurar uma VM não gerenciada como discos não gerenciados usando a conta de armazenamento original
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -Name "UnManagedVM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem[0] -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -UseOriginalStorageAccount -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre RecoveryServices e o armazena em $vault variável. O segundo comando obtém o item Backup e, em seguida, armazena-o na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, armazena-a na variável $StartDate. O quarto comando obtém a data atual e, em seguida, armazena-a na variável $EndDate. O quinto comando obtém uma lista de pontos de recuperação para o item de backup específico filtrado por $StartDate e $EndDate. O sexto comando restaura os discos como discos não gerenciados para suas contas de armazenamento originais
Exemplo 6: Restaurar vários arquivos de um item AzureFileShare
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureStorage -WorkloadType AzureVM -VaultId $vault.ID -Name "fileshareitem"
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -VaultId $vault.ID
$files = ("file1.txt", "file2.txt")
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -MultipleSourceFilePath $files -SourceFileType File -ResolveConflict Overwrite -VaultId $vault.ID -VaultLocation $vault.Location
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
fileshareitem Restore InProgress 26-Apr-16 1:14:01 PM 01-Jan-01 12:00:00 AMO primeiro comando obtém o cofre dos Serviços de Recuperação e o armazena em $vault variável. O segundo comando obtém o item Backup chamado fileshareitem e, em seguida, armazena-o na variável $BackupItem. O terceiro comando obtém uma lista de pontos de recuperação para o item de backup específico. O quarto comando especifica quais arquivos restaurar e armazena em $files variável. O último comando restaura os arquivos especificados para seu local original.
Exemplo 7: Restaurar um banco de dados SQL em uma VM do Azure para outra VM de destino para um ponto de recuperação completo distinto
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload -WorkloadType MSSQL -VaultId $vault.ID -Name "MSSQLSERVER;model"
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$FullRP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$TargetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL -ItemType SQLInstance -Name "<SQLInstance Name>" -ServerName "<SQL VM name>" -VaultId $vault.ID
$AnotherInstanceWithFullConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig -RecoveryPoint $FullRP -TargetItem $TargetInstance -AlternateWorkloadRestore -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $AnotherInstanceWithLogConfig -VaultId $vault.ID
WorkloadName Operation Status StartTime EndTime JobID
------------ --------- ------ --------- ------- -----
MSSQLSERVER/m... Restore InProgress 3/17/2019 10:02:45 AM 3274xg2b-e4fg-5952-89b4-8cb566gc1748Exemplo 8: Restaurar um banco de dados SQL em uma VM do Azure para outra VM de destino para um ponto de recuperação de log
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload -WorkloadType MSSQL -VaultId $vault.ID -Name "MSSQLSERVER;model"
$PointInTime = Get-Date -Date "2019-03-20 01:00:00Z"
$TargetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL -ItemType SQLInstance -Name "<SQLInstance Name>" -ServerName "<SQL VM name>" -VaultId $vault.ID
$AnotherInstanceWithLogConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig -PointInTime $PointInTime -Item $BackupItem -AlternateWorkloadRestore -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $AnotherInstanceWithLogConfig -VaultId $vault.ID
WorkloadName Operation Status StartTime EndTime JobID
------------ --------- ------ --------- ------- -----
MSSQLSERVER/m... Restore InProgress 3/17/2019 10:02:45 AM 3274xg2b-e4fg-5952-89b4-8cb566gc1748Exemplo 9: Rehydrate Restore para IaasVM a partir de um ponto de recuperação arquivado
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3] -Tier VaultArchive
$restoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $rp[0] -RehydratePriority "Standard" -RehydrateDuration "13" -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -RestoreDiskList $restoreDiskLUNs -VaultId $vault.ID -VaultLocation $vault.LocationAqui filtramos os pontos de recuperação presentes na camada VaultArchive e acionamos uma restauração com prioridade de reidratação e duração de reidratação.
Exemplo 10: Restauração interzonal para VM não ZonePinned em um vault do ZRS
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3] -Tier VaultStandard
$restoreJob = Restore-AzRecoveryServicesBackupItem -VaultId $vault.ID -VaultLocation $vault.Location -RecoveryPoint $rp[0] -StorageAccountName "saName" -StorageAccountResourceGroupName $vault.ResourceGroupName -TargetResourceGroupName $vault.ResourceGroupName -TargetVMName "targetVMName" -TargetVNetName "targetVNet" -TargetVNetResourceGroup $vault.ResourceGroupName -TargetSubnetName "default" -TargetZoneNumber 2Aqui, filtramos os pontos de recuperação presentes na camada VaultStandard e acionamos uma restauração interzonal para VM não ZonePinned em um vault ZRS. Para CZR passamos -TargetZoneNumber parâmetro. Para VM não zoneada, o CZR é suportado apenas para cofres ZRS. Para VMs ZonePinned CZR é suportado para vaults ZRS e restauração entre regiões para região secundária para vaults habilitados para CRR. Podemos usar pontos de recuperação habilitados para instantâneo ou camada compartimentada para CZR com uma limitação de que o ponto de recuperação de instantâneo deve ter mais de 4 horas.
Exemplo 11: Restauração da zona de borda para uma VM gerenciada do AzureVM para local alternativo
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3]
$restoreJob = Restore-AzRecoveryServicesBackupItem -VaultId $vault.ID -VaultLocation $vault.Location -RecoveryPoint $rp[0] -StorageAccountName "saName" -StorageAccountResourceGroupName $vault.ResourceGroupName -TargetResourceGroupName $vault.ResourceGroupName -TargetVMName "targetVMName" -TargetVNetName "targetVNet" -TargetVNetResourceGroup $vault.ResourceGroupName -TargetSubnetName "default" -TargetZoneNumber 2 -RestoreToEdgeZoneNeste exemplo, usamos o parâmetro RestoreToEdgeZone para disparar uma restauração para uma nova vm de zona de borda em local alternativo. Para OLR (restauração de local original), a restauração será implicitamente uma restauração de zona de borda se a VM de origem for uma VM de zona de borda.
Exemplo 12: Restaurar uma VM do AzureVM gerenciada usando DiskAccessOption
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -VaultId $vault.ID -Item $item
$AlternateLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -TargetVMName "TagetVirtualMachineName" -TargetVNetName "Target_VNet" -TargetVNetResourceGroup "Target_VNet_RG" -TargetSubnetName "subnetName" -VaultId $vault.ID -VaultLocation $vault.Location -DiskAccessOption EnablePrivateAccessForAllDisks -TargetDiskAccessId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rgName/providers/Microsoft.Compute/diskAccesses/target-diskaccess"
WorkloadName Operation Status StartTime EndTime
------------ --------- ------ --------- -------
V2VM Restore InProgress 26-Jul-24 1:14:01 PM 01-Jan-01 12:00:00 AMNeste exemplo, usamos o parâmetro DiskAccessOption para disparar uma restauração para uma nova VM com acesso privado habilitado para todos os discos. O parâmetro DiskAccessOption pode ser usado para especificar a opção de acesso ao disco para discos de destino. Os valores aceitáveis para este parâmetro são: SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks. O parâmetro TargetDiskAccessId é usado para especificar a ID de acesso ao disco para os discos de destino. Esse parâmetro é necessário quando DiskAccessOption é definido como EnablePrivateAccessForAllDisks.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DiskAccessOption
Especifica a opção de acesso ao disco para discos de destino
| Tipo: | Nullable<T>[TargetDiskNetworkAccessOption] |
| Valores aceites: | SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DiskEncryptionSetId
O DES ID para encriptar os discos restaurados.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-MultipleSourceFilePath
Usado para vários arquivos restaurar a partir de um compartilhamento de arquivos. Os caminhos dos itens a serem restaurados dentro do compartilhamento de arquivos.
| Tipo: | String[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RecoveryPoint
Especifica o ponto de recuperação para o qual restaurar o item de backup. Para obter um objeto AzureRmRecoveryServicesBackupRecoveryPoint, use o cmdlet Get-AzRecoveryServicesBackupRecoveryPoint.
| Tipo: | RecoveryPointBase |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-RehydrateDuration
Duração em dias para manter o ponto de recuperação arquivado reidratado. O valor pode variar de 10 a 30 dias, o valor padrão é 15 dias.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RehydratePriority
Prioridade de reidratação para um ponto de recuperação arquivado ao acionar a restauração. Os valores aceitáveis são Padrão, Alto.
| Tipo: | String |
| Valores aceites: | Standard, High |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ResolveConflict
Caso o item restaurado também exista no destino, use isso para indicar se deseja substituir ou não. Os valores aceitáveis para este parâmetro são:
- Substituir
- Pular
| Tipo: | RestoreFSResolveConflictOption |
| Valores aceites: | Overwrite, Skip |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreAsManagedDisk
Use essa opção para especificar a restauração como discos gerenciados.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreAsUnmanagedDisks
Use esta opção para especificar a restauração como discos não gerenciados
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreDiskList
Especificar quais discos recuperar da VM de backup
| Tipo: | String[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreOnlyOSDisk
Use essa opção para restaurar apenas discos do sistema operacional de uma VM de backup
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreToEdgeZone
Parâmetro de switch para indicar a restauração da VM da zona de borda. Este parâmetro não pode ser usado no cenário de restauração de assinatura entre regiões e corss
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RestoreToSecondaryRegion
Use essa opção para acionar a restauração da região cruzada para a região secundária.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SourceFilePath
Usado para uma restauração de item específico a partir de um compartilhamento de arquivos. O caminho do item a ser restaurado dentro do compartilhamento de arquivos.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SourceFileType
Usado para uma restauração de item específico a partir de um compartilhamento de arquivos. O tipo do item a ser restaurado dentro do compartilhamento de arquivos. Os valores aceitáveis para este parâmetro são:
- Ficheiro
- Diretório
| Tipo: | Nullable<T>[SourceFileType] |
| Valores aceites: | File, Directory |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-StorageAccountName
Especifica o nome da conta de armazenamento de destino na sua assinatura. Como parte do processo de restauração, este cmdlet armazena os discos e as informações de configuração nesta conta de armazenamento.
| Tipo: | String |
| Position: | 1 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-StorageAccountResourceGroupName
Especifica o nome do grupo de recursos que contém a conta de armazenamento de destino em sua assinatura. Como parte do processo de restauração, este cmdlet armazena os discos e as informações de configuração nesta conta de armazenamento.
| Tipo: | String |
| Position: | 2 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetDiskAccessId
Especifica o ID de acesso ao disco de destino quando DiskAccessOption definido como EnablePrivateAccessForAllDisks
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetFileShareName
O Compartilhamento de Arquivos para o qual o compartilhamento de arquivos deve ser restaurado.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetFolder
A pasta sob a qual o compartilhamento de arquivos deve ser restaurado dentro do TargetFileShareName. Se o conteúdo do backup for restaurado para uma pasta raiz, forneça os valores da pasta de destino como uma cadeia de caracteres vazia.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetResourceGroupName
O grupo de recursos para o qual os discos gerenciados são restaurados. Aplicável ao backup de VM com discos gerenciados
| Tipo: | String |
| Position: | 3 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetStorageAccountName
A conta de armazenamento para a qual o compartilhamento de arquivos deve ser restaurado.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetSubnetName
Nome da sub-rede na qual a VM de destino deve ser criada, no caso de restauração de Local Alternativo para uma nova VM
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetSubscriptionId
ID da assinatura de destino para a qual o recurso deve ser restaurado. Use este parâmetro para restauração de assinatura cruzada
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetVMName
Nome da VM para a qual os dados devem ser restaurados, no caso de restauração de Local Alternativo para uma nova VM
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetVNetName
Nome da VNet na qual a VM de destino deve ser criada, no caso de restauração de Local Alternativo para uma nova VM
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetVNetResourceGroup
Nome do grupo de recursos que contém a rede virtual de destino, no caso de restauração de local alternativo para uma nova VM
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TargetZoneNumber
O número da zona de disponibilidade de destino onde os discos restaurados são fixados.
| Tipo: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Token
Parâmetro para autorizar operações protegidas pelo protetor de recursos entre locatários. Use o comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token para buscar token de autorização para locatário diferente
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UseOriginalStorageAccount
Use essa opção se os discos do ponto de recuperação forem restaurados para suas contas de armazenamento originais.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserAssignedIdentityId
UserAssigned Identity Id para acionar a restauração baseada em MSI com UserAssigned Identity
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UseSystemAssignedIdentity
Use essa opção para acionar a restauração baseada em MSI com SystemAssigned Identity
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VaultId
ID ARM do Cofre dos Serviços de Recuperação.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-VaultLocation
Localização do Cofre dos Serviços de Recuperação.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-WLRecoveryConfig
Configuração de recuperação
| Tipo: | RecoveryConfigBase |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Entradas
Saídas
Ligações Relacionadas
Azure PowerShell