Partilhar via


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.

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

Nota

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 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 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, 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 "" -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, 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 usar 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 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, 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 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, 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 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, 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 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, 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-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: 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.Location

Aqui 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 2

Aqui, 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 o parâmetro -TargetZoneNumber. 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 -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 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.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predefinido:None
Necessário: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.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskEncryptionSetId

O DES ID para encriptar os discos restaurados.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário: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 .

Tipo:RecoveryPointBase
Position:0
valor predefinido:None
Necessário: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 é 15 dias.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário: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 este parâmetro são:

  • Substituir
  • Ignorar
Tipo:RestoreFSResolveConflictOption
valores aceites:Overwrite, Skip
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsManagedDisk

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsUnmanagedDisks

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreDiskList

Especificar quais discos recuperar da VM de backup

Tipo:String[]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreOnlyOSDisk

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:False
Necessário: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 dentro do compartilhamento de arquivos.

Tipo:String
Position:Named
valor predefinido:None
Necessário: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 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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário: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, este cmdlet armazena os discos e as informações de configuração nesta conta de armazenamento.

Tipo:String
Position:2
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetFileShareName

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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetResourceGroupName

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

Tipo:String
Position:3
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetStorageAccountName

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

Tipo:String
Position:Named
valor predefinido:None
Necessário: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

Tipo:String
Position:Named
valor predefinido:None
Necessário: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

Tipo:String
Position:Named
valor predefinido:None
Necessário: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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário: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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetZoneNumber

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

Tipo:Nullable<T>[Int32]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário: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.

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentityId

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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSystemAssignedIdentity

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-VaultLocation

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

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-WLRecoveryConfig

Configuração de recuperação

Tipo:RecoveryConfigBase
Position:0
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

RecoveryPointBase

Saídas

JobBase