Restore-AzRecoveryServicesBackupItem

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 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.

Syntax

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-DiskEncryptionSetId <String>]
       [-RestoreToSecondaryRegion]
       [-TargetZoneNumber <Int32>]
       [-RehydratePriority <String>]
       [-UseSystemAssignedIdentity]
       [-UserAssignedIdentityId <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <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]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <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>]
       [-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>]
       [-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>]
       [-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>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-WLRecoveryConfig] <RecoveryConfigBase>
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <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 backup de 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 esta for uma VM de disco gerenciado, um grupo de Recursos de destino deverá ser especificado onde os discos restaurados serão mantidos. Quando o grupo de recursos de destino for especificado, se os instantâneos estiverem presentes no grupo de recursos especificado na diretiva 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 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 snapshots estarão presentes na conta de armazenamento original do disco e/ou no cofre de 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 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 seletivamente de discos relevantes usando os parâmetros exclusionList ou InclusionList durante o Enable-Backup. A opção de restaurar seletivamente discos só estará disponível se houver backup seletivo.

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

Observação

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

Para 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 com 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 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, armazena-a na variável $StartDate. O quarto comando obtém a data atual e 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 Target_RG do grupo de recursos de destino 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 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 "" -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, armazena-a na variável $StartDate. O quarto comando obtém a data atual e 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 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 de backup original no local original, isso poderá ser feito com o último comando. Evite usar 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, armazena-a na variável $StartDate. O quarto comando obtém a data atual e 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 Target_RG de destino 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 AM

O primeiro comando obtém o cofre do 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, armazena-a na variável $StartDate. O quarto comando obtém a data atual e 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 do 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, armazena-a na variável $StartDate. O quarto comando obtém a data atual e 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 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 obter 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 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-8cb566gc1748

Exemplo 9: Restauração reidratada 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.Location

Aqui, filtramos os pontos de recuperação presentes na camada do VaultArchive e acionamos 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 acionamos uma restauração zonal cruzada para VM não ZonePinned em um cofre ZRS. Para CZR passamos o parâmetro -TargetZoneNumber. Para VM não zoneada, o CZR é suportado apenas para cofres ZRS. Para VMs ZonePinned, o 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 snapshot ou camada compartimentada para CZR com uma limitação de que o ponto de recuperação de snapshot deve ter mais de 4 horas de idade.

Exemplo 11: Restauração da zona de borda de uma AzureVM gerenciada para um 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 a nova vm de zona de borda em local alternativo. Para Restauração de local original (OLR), a restauração será implicitamente uma restauração de zona de borda se a VM de origem for uma VM de zona de borda.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskEncryptionSetId

O ID do DES para criptografar os discos restaurados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:RecoveryPointBase
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 é de 15 dias.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RehydratePriority

Prioridade de reidratação para um ponto de recuperação arquivado enquanto aciona a restauração. Os valores aceitáveis são Padrão, Alto.

Type:String
Accepted values:Standard, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 esse parâmetro são:

  • Overwrite
  • Ignorar
Type:RestoreFSResolveConflictOption
Accepted values:Overwrite, Skip
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsManagedDisk

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsUnmanagedDisks

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreDiskList

Especificar quais discos recuperar da VM de backup

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreOnlyOSDisk

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreToEdgeZone

Parâmetro Switch 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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreToSecondaryRegion

Use essa opção para acionar a restauração de região cruzada para a região secundária.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 no compartilhamento de arquivos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 no compartilhamento de arquivos. Os valores aceitáveis para esse parâmetro são:

  • Arquivo
  • Diretório
Type:Nullable<T>[SourceFileType]
Accepted values:File, Directory
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 nessa conta de armazenamento.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 nessa conta de armazenamento.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetFileShareName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetFolder

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetResourceGroupName

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetStorageAccountName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetVNetName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetZoneNumber

O número da zona de disponibilidade de destino onde os discos restaurados estão fixados.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseOriginalStorageAccount

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentityId

UserAssigned Identity Id para disparar a restauração baseada em MSI com UserAssigned Identity

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSystemAssignedIdentity

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VaultLocation

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WLRecoveryConfig

Configuração de recuperação

Type:RecoveryConfigBase
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

RecoveryPointBase

Saídas

JobBase