Restore-AzRecoveryServicesBackupItem

Módulo:

Az.RecoveryServices

Restaura os dados e a configuração de um item de Backup para o ponto de recuperação especificado. Os parâmetros necessários variam com o tipo de item de backup. O mesmo comando é usado para restaurar máquinas virtuais do Azure, bancos de dados em execução em 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 de Backup do Azure para um ponto de recuperação especificado.

para o backup da VM do Azure

Você pode fazer backup de máquinas virtuais do Azure e restaurar discos (gerenciados e não gerenciados) usando esse comando. A operação de restauração não restaura a máquina virtual completa. Se essa for uma VM de disco gerenciado, um grupo de recursos de destino deverá ser especificado onde os discos restaurados são mantidos. Quando o grupo de recursos de destino for 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. Também há uma opção para restaurá-los como discos não gerenciados, mas isso aproveitará os dados presentes no cofre dos serviços de recuperação do Azure e, portanto, será muito mais lento. A configuração da VM e do modelo de implantação que pode ser usada para criar VM a partir dos discos restaurados será baixada para a conta de armazenamento especificada. Se essa for uma VM de disco não gerenciado, 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 fornecer 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 são buscados do cofre dos serviços de Recuperação do Azure e os discos são criados na conta de armazenamento especificada, juntamente com a configuração da VM e do modelo de implantação.

Importante

Por padrão, o backup da VM do Azure faz backup de todos os discos. Você pode fazer backup seletivo 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 houver backup seletivo deles.

Consulte diferentes conjuntos de parâmetros possíveis e texto de parâmetro para obter mais informações.

Nota

Se -VaultId parâmetro for usado, -VaultLocation parâmetro também deverá ser usado.

para o 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 os bancos de dados SQL em VMs do Azure

Exemplos

Exemplo 1: restaurar os discos de uma VM do Azure de disco gerenciado com 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
$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 AM

O 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, a armazena na variável $StartDate. O quarto comando obtém a data atual e, em seguida, a armazena 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 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 AzureVM gerenciada de um determinado ponto de recuperação para um 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 AM

O 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, a armazena na variável $StartDate. O quarto comando obtém a data atual e, em seguida, a armazena 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 ALR (Restauração de Localização Alternativa) para criar uma nova VM no grupo de recursos Target_RG 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 com backup original no local original, isso poderá ser feito com o último comando. Evite usando os parâmetros TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName para executar a Restauração de Local Original (OLR).

Exemplo 3: restaurar discos especificados de uma VM do Azure de disco gerenciado com 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 AM

O 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, a armazena na variável $StartDate. O quarto comando obtém a data atual e, em seguida, a armazena 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 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 AM

O primeiro comando obtém o cofre RecoveryServices e o armazena em $vault variável. O segundo comando obtém o item backup e o armazena na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, a armazena na variável $StartDate. O quarto comando obtém a data atual e, em seguida, a armazena 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 AM

O primeiro comando obtém o cofre RecoveryServices e o armazena em $vault variável. O segundo comando obtém o item backup e o armazena na variável $BackupItem. O terceiro comando obtém a data de sete dias antes e, em seguida, a armazena na variável $StartDate. O quarto comando obtém a data atual e, em seguida, a armazena 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 do 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 AM

O 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 o armazena 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 restaurá-los e armazená-los em $files variável. O último comando restaura os arquivos especificados para seu local original.

Exemplo 7: Restaurar um banco de dados SQL dentro de 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-8cb566gc1748

Exemplo 8: Restaurar um banco de dados SQL dentro de 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-8cb566gc1748

Exemplo 9: reidratar a restauração para IaasVM 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.Location

Aqui, filtramos os pontos de recuperação presentes na camada VaultArchive e disparamos uma restauração com prioridade de reidratação e duração da reidratação.

Exemplo 10: restauração zonal cruzada para VM não ZonePinned em um cofre 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 2

Aqui, filtramos os pontos de recuperação presentes na camada VaultStandard e disparamos uma restauração zonal cruzada para VM não ZonePinned em um cofre ZRS. Para CZR, passamos -TargetZoneNumber parâmetro. Para VM não ZonedPinned, o CZR tem suporte apenas para cofres ZRS. Para VMs ZonePinned, há suporte para cofres ZRS e restauração entre regiões para a região secundária para cofres habilitados para CRR. Podemos usar pontos de recuperação habilitados para instantâneo ou de camada abobadada para CZR com uma limitação de que o ponto de recuperação de instantâneo deve ter mais de 4 horas de idade.

Exemplo 11: Restauração de zona de borda para uma AzureVM gerenciada 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 -RestoreToEdgeZone

Neste exemplo, usamos o parâmetro RestoreToEdgeZone para disparar uma restauração para uma nova VM de zona de borda em local alternativo. Para a 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 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 AM

Neste 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 esse 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 a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DiskAccessOption

Especifica a opção de acesso ao disco para discos de destino

Tipo:	Nullable<T>[TargetDiskNetworkAccessOption]
Valores aceitos:	SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DiskEncryptionSetId

A ID do DES para criptografar os discos restaurados.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MultipleSourceFilePath

Usado para restauração de vários arquivos de um compartilhamento de arquivos. Os caminhos dos itens a serem restaurados no compartilhamento de arquivos.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RehydrateDuration

Duração em dias para os quais 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
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RehydratePriority

Prioridade de reidratação para um ponto de recuperação arquivado ao disparar a restauração. Os valores aceitáveis são Standard, High.

Tipo:	String
Valores aceitos:	Standard, High
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResolveConflict

Caso o item restaurado também exista no destino, use-o para indicar se deseja substituir ou não. Os valores aceitáveis para este parâmetro são:

• Sobrescrever
• Saltitar

Tipo:	RestoreFSResolveConflictOption
Valores aceitos:	Overwrite, Skip
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreAsManagedDisk

Use essa opção para especificar a restauração como discos gerenciados.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreAsUnmanagedDisks

Use essa opção para especificar a restauração como discos não gerenciados

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreDiskList

Especificar quais discos recuperar da VM com backup

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreOnlyOSDisk

Use essa opção para restaurar apenas discos do sistema operacional de uma VM com backup

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreToEdgeZone

Alterne o parâmetro para indicar a restauração da VM da zona de borda. Esse parâmetro não pode ser usado no cenário de restauração de assinatura entre regiões e corss

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RestoreToSecondaryRegion

Use essa opção para disparar a restauração entre regiões para a região secundária.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SourceFilePath

Usado para uma restauração de item específica de um compartilhamento de arquivo. O caminho do item a ser restaurado dentro do compartilhamento de arquivos.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SourceFileType

Usado para uma restauração de item específica de um compartilhamento de arquivo. O tipo do item a ser restaurado no compartilhamento de arquivos. Os valores aceitáveis para este parâmetro são:

• Arquivo
• Diretório

Tipo:	Nullable<T>[SourceFileType]
Valores aceitos:	File, Directory
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageAccountName

Especifica o nome da conta de Armazenamento de destino em sua assinatura. Como parte do processo de restauração, esse cmdlet armazena os discos e as informações de configuração nesta conta de Armazenamento.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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, esse cmdlet armazena os discos e as informações de configuração nesta conta de Armazenamento.

Tipo:	String
Cargo:	2
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetDiskAccessId

Especifica a ID de acesso ao disco de destino quando DiskAccessOption é definido como EnablePrivateAccessForAllDisks

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetFileShareName

O Compartilhamento de Arquivos para o qual o compartilhamento de arquivos deve ser restaurado.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetFolder

A pasta na qual o compartilhamento de arquivos deve ser restaurado no TargetFileShareName. Se o conteúdo de backup for restaurado para uma pasta raiz, forneça os valores da pasta de destino como uma cadeia de caracteres vazia.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetResourceGroupName

O grupo de recursos para o qual os discos gerenciados são restaurados. Aplicável ao backup da VM com discos gerenciados

Tipo:	String
Cargo:	3
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetStorageAccountName

A conta de armazenamento para a qual o compartilhamento de arquivos deve ser restaurado.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetSubnetName

Nome da sub-rede na qual a VM de destino deve ser criada, no caso da restauração de Local Alternativo para uma nova VM

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetSubscriptionId

ID da assinatura de destino à qual o recurso deve ser restaurado. Use esse parâmetro para restauração entre assinaturas

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetVMName

Nome da VM para a qual os dados devem ser restaurados, no caso da restauração de Local Alternativo para uma nova VM

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetVNetName

Nome da VNet na qual a VM de destino deve ser criada, no caso da restauração de Local Alternativo para uma nova VM

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetVNetResourceGroup

Nome do grupo de recursos que contém a VNet de destino, no caso da restauração de Local Alternativo para uma nova VM

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TargetZoneNumber

O número da zona de disponibilidade de destino em que os discos restaurados são fixados.

Tipo:	Nullable<T>[Int32]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Token

Parâmetro para autorizar operações protegidas pelo proteção de recursos entre locatários. Usar comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx"). Token para buscar token de autorização para locatário diferente

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseOriginalStorageAccount

Use essa opção se os discos do ponto de recuperação forem restaurados para suas contas de armazenamento originais.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UserAssignedIdentityId

ID de identidade UserAssigned para disparar a restauração baseada em MSI com a Identidade UserAssigned

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseSystemAssignedIdentity

Use essa opção para disparar a restauração baseada em MSI com a Identidade SystemAssigned

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-VaultId

ID do ARM do Cofre dos Serviços de Recuperação.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-VaultLocation

Local do Cofre dos Serviços de Recuperação.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WLRecoveryConfig

Configuração de recuperação

Tipo:	RecoveryConfigBase
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

Entradas

String

RecoveryPointBase

Saídas

JobBase

Links Relacionados

• Backup-AzRecoveryServicesBackupItem
• Get-AzRecoveryServicesBackupItem
• Get-AzRecoveryServicesBackupRecoveryPoint