Restore-AzRecoveryServicesBackupItem

Módulo:

Az.RecoveryServices

Restaura los datos y la configuración de un elemento de copia de seguridad en el punto de recuperación especificado. Los parámetros necesarios varían con el tipo de elemento de copia de seguridad. El mismo comando se usa para restaurar máquinas virtuales de Azure, bases de datos que se ejecutan en máquinas virtuales de Azure y recursos compartidos de archivos de Azure.

Sintaxis

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

El cmdlet Restore-AzRecoveryServicesBackupItem restaura los datos y la configuración de un elemento de Azure Backup en un punto de recuperación especificado.

Para la copia de seguridad de máquinas virtuales de Azure

Puede realizar copias de seguridad de máquinas virtuales de Azure y restaurar discos (administrados y no administrados) mediante este comando. La operación de restauración no restaura la máquina virtual completa. Si se trata de una máquina virtual de disco administrado, se debe especificar un grupo de recursos de destino donde se conservan los discos restaurados. Cuando se especifica el grupo de recursos de destino, si las instantáneas están presentes en el grupo de recursos especificado en la directiva de copia de seguridad, la operación de restauración será instantánea y los discos se crean a partir de instantáneas locales y se mantienen en el grupo de recursos de destino. También hay una opción para restaurarlos como discos no administrados, pero esto aprovechará los datos presentes en el almacén de Azure Recovery Services y, por tanto, será mucho más lento. La configuración de la máquina virtual y la plantilla de implementación que se puede usar para crear la máquina virtual fuera de los discos restaurados se descargarán en la cuenta de almacenamiento especificada. Si se trata de una máquina virtual de disco no administrado, las instantáneas están presentes en la cuenta de almacenamiento original del disco o en el almacén de Recovery Services. Si el usuario ofrece una opción para usar la cuenta de almacenamiento original para restaurar, se puede proporcionar la restauración instantánea. De lo contrario, los datos se capturan del almacén de Azure Recovery Services y los discos se crean en la cuenta de almacenamiento especificada junto con la configuración de la máquina virtual y la plantilla de implementación.

Importante

De forma predeterminada, la copia de seguridad de máquinas virtuales de Azure realiza una copia de seguridad de todos los discos. Puede realizar copias de seguridad selectiva de discos relevantes mediante los parámetros exclusionList o InclusionList durante Enable-Backup. La opción para restaurar de forma selectiva los discos solo está disponible si se ha realizado una copia de seguridad selectiva de ellos.

Consulte diferentes conjuntos de parámetros posibles y texto de parámetros para obtener más información.

Nota:

Si se usa el parámetro -VaultId, también se debe usar el parámetro -VaultLocation.

Para la copia de seguridad de recursos compartidos de archivos de Azure

Puede restaurar un recurso compartido de archivos completo o archivos o carpetas específicos o múltiples en el recurso compartido. Puede restaurar en la ubicación original o en una ubicación alternativa.

Para cargas de trabajo de Azure

Puede restaurar bases de datos SQL en máquinas virtuales de Azure.

Ejemplos

Ejemplo 1: Restauración de los discos de una máquina virtual de Azure de disco administrado de copia de seguridad desde un punto de recuperación determinado

$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

El primer comando obtiene el almacén de Recovery Services y lo almacena en $vault variable. El segundo comando obtiene el elemento Backup de tipo AzureVM, del nombre "V2VM" y lo almacena en la variable $BackupItem. El tercer comando obtiene la fecha de siete días antes y, a continuación, la almacena en la variable $StartDate. El cuarto comando obtiene la fecha actual y, a continuación, la almacena en la variable $EndDate. El quinto comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico filtrado por $StartDate y $EndDate. El último comando restaura todos los discos en el grupo de recursos de destino Target_RG y, a continuación, proporciona la información de configuración de la máquina virtual y la plantilla de implementación en la cuenta de almacenamiento DestAccount en el grupo de recursos DestRG.

Ejemplo 2: Restauración de una instancia administrada de AzureVM desde un punto de recuperación determinado a una ubicación original o alternativa

$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

El primer comando obtiene el almacén de Recovery Services y lo almacena en $vault variable. El segundo comando obtiene el elemento Backup de tipo AzureVM, del nombre "V2VM" y lo almacena en la variable $BackupItem. El tercer comando obtiene la fecha de siete días antes y, a continuación, la almacena en la variable $StartDate. El cuarto comando obtiene la fecha actual y, a continuación, la almacena en la variable $EndDate. El quinto comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico filtrado por $StartDate y $EndDate. El sexto comando desencadena una restauración de ubicación alternativa (ALR) para crear una máquina virtual en Target_RG grupo de recursos según las entradas especificadas por los parámetros TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. Como alternativa, si un usuario quiere realizar una restauración local en la máquina virtual de la que se ha realizado la copia de seguridad original en la ubicación original, se puede realizar con el último comando. Evite usar TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName para realizar la restauración de ubicación original (OLR).

Ejemplo 3: Restauración de discos especificados de una máquina virtual de Azure de disco administrado de copia de seguridad desde un punto de recuperación determinado

$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

El primer comando obtiene el almacén de Recovery Services y lo almacena en $vault variable. El segundo comando obtiene el elemento Backup de tipo AzureVM, del nombre "V2VM" y lo almacena en la variable $BackupItem. El tercer comando obtiene la fecha de siete días antes y, a continuación, la almacena en la variable $StartDate. El cuarto comando obtiene la fecha actual y, a continuación, la almacena en la variable $EndDate. El quinto comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico filtrado por $StartDate y $EndDate. El sexto comando almacena la lista de discos que se van a restaurar en la variable restoreDiskLUN. El último comando restaura los discos especificados, de los LUN especificados, al grupo de recursos de destino Target_RG y, a continuación, proporciona la información de configuración de la máquina virtual y la plantilla de implementación en la cuenta de almacenamiento DestAccount en el grupo de recursos DestRG.

Ejemplo 4: Restauración de discos de una máquina virtual administrada como discos no administrados

$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

El primer comando obtiene el almacén recoveryServices y lo almacena en $vault variable. El segundo comando obtiene el elemento Backup y, a continuación, lo almacena en la variable $BackupItem. El tercer comando obtiene la fecha de siete días antes y, a continuación, la almacena en la variable $StartDate. El cuarto comando obtiene la fecha actual y, a continuación, la almacena en la variable $EndDate. El quinto comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico filtrado por $StartDate y $EndDate. El sexto comando restaura los discos como discos no administrados.

Ejemplo 5: Restauración de una máquina virtual no administrada como discos no administrados mediante la cuenta de almacenamiento 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

El primer comando obtiene el almacén recoveryServices y lo almacena en $vault variable. El segundo comando obtiene el elemento Backup y, a continuación, lo almacena en la variable $BackupItem. El tercer comando obtiene la fecha de siete días antes y, a continuación, la almacena en la variable $StartDate. El cuarto comando obtiene la fecha actual y, a continuación, la almacena en la variable $EndDate. El quinto comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico filtrado por $StartDate y $EndDate. El sexto comando restaura los discos como discos no administrados en sus cuentas de almacenamiento originales.

Ejemplo 6: Restauración de varios archivos de un elemento 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

El primer comando obtiene el almacén de Recovery Services y lo almacena en $vault variable. El segundo comando obtiene el elemento backup denominado fileshareitem y, a continuación, lo almacena en la variable $BackupItem. El tercer comando obtiene una lista de puntos de recuperación para el elemento de copia de seguridad específico. El cuarto comando especifica qué archivos se van a restaurar y los almacena en $files variable. El último comando restaura los archivos especificados en su ubicación original.

Ejemplo 7: Restauración de una base de datos SQL dentro de una máquina virtual de Azure a otra máquina virtual de destino para un punto de recuperación 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

Ejemplo 8: Restauración de una base de datos SQL dentro de una máquina virtual de Azure a otra máquina virtual de destino para un punto de recuperación de registro

$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

Ejemplo 9: Rehidratación de la restauración para IaasVM desde un punto de recuperación archivado

$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

Aquí filtramos los puntos de recuperación presentes en el nivel VaultArchive y desencadenamos una restauración con prioridad de rehidratación y duración de rehidratación.

Ejemplo 10: Restauración entre zonas para máquinas virtuales que no son ZonePinned en un almacén de 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

Aquí se filtran los puntos de recuperación presentes en el nivel VaultStandard y se desencadena una restauración entre zonas para máquinas virtuales que no son ZonePinned en un almacén de ZRS. Para CZR, pasamos el parámetro -TargetZoneNumber. En el caso de máquinas virtuales que no son zonedPinned, CZR solo se admite para almacenes ZRS. En el caso de las máquinas virtuales ZonePinned, CZR se admite para almacenes de ZRS y la restauración entre regiones en la región secundaria para almacenes habilitados para CRR. Podemos usar puntos de recuperación habilitados para instantáneas o niveles de almacén para CZR con una limitación de que el punto de recuperación de instantáneas debe tener más de 4 horas de antigüedad.

Ejemplo 11: restauración de zona perimetral para una instancia administrada de AzureVM en una ubicación alternativa

$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

En este ejemplo, usamos el parámetro RestoreToEdgeZone para desencadenar una restauración en una nueva máquina virtual de zona perimetral en una ubicación alternativa. En el caso de la restauración de ubicación original (OLR), la restauración será implícitamente una restauración de zona perimetral si la máquina virtual de origen es una máquina virtual de zona perimetral.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DiskEncryptionSetId

Identificador de DES para cifrar los discos restaurados.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MultipleSourceFilePath

Se usa para la restauración de varios archivos desde un recurso compartido de archivos. Rutas de acceso de los elementos que se van a restaurar dentro del recurso compartido de archivos.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RecoveryPoint

Especifica el punto de recuperación al que se va a restaurar el elemento de copia de seguridad. Para obtener un objeto AzureRmRecoveryServicesBackupRecoveryPoint , use el cmdlet Get-AzRecoveryServicesBackupRecoveryPoint .

Tipo:	RecoveryPointBase
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RehydrateDuration

Duración en días para los que se mantiene rehidratado el punto de recuperación archivado. El valor puede oscilar entre 10 y 30 días, el valor predeterminado es de 15 días.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RehydratePriority

Prioridad de rehidratación para un punto de recuperación archivado al desencadenar la restauración. Los valores aceptables son Standard, High.

Tipo:	String
Valores aceptados:	Standard, High
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResolveConflict

En caso de que el elemento restaurado también exista en el destino, úselo para indicar si se debe sobrescribir o no. Los valores permitidos para este parámetro son los siguientes:

• Sobrescribir
• Omitir

Tipo:	RestoreFSResolveConflictOption
Valores aceptados:	Overwrite, Skip
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreAsManagedDisk

Use este modificador para especificar que se restaure como discos administrados.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreAsUnmanagedDisks

Use este modificador para especificar que se restaure como discos no administrados.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreDiskList

Especificación de los discos que se van a recuperar de la máquina virtual de copia de seguridad

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreOnlyOSDisk

Use este modificador para restaurar solo discos del sistema operativo de una máquina virtual de copia de seguridad.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreToEdgeZone

Cambie el parámetro para indicar la restauración de máquinas virtuales de zona perimetral. Este parámetro no se puede usar en el escenario de restauración de suscripciones entre regiones y corss

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreToSecondaryRegion

Use este modificador para desencadenar la restauración entre regiones a la región secundaria.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SourceFilePath

Se usa para una restauración de elementos determinada desde un recurso compartido de archivos. Ruta de acceso del elemento que se va a restaurar en el recurso compartido de archivos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SourceFileType

Se usa para una restauración de elementos determinada desde un recurso compartido de archivos. Tipo del elemento que se va a restaurar dentro del recurso compartido de archivos. Los valores permitidos para este parámetro son los siguientes:

• Archivo
• Directorio

Tipo:	Nullable<T>[SourceFileType]
Valores aceptados:	File, Directory
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageAccountName

Especifica el nombre de la cuenta de almacenamiento de destino en la suscripción. Como parte del proceso de restauración, este cmdlet almacena los discos y la información de configuración de esta cuenta de almacenamiento.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageAccountResourceGroupName

Especifica el nombre del grupo de recursos que contiene la cuenta de almacenamiento de destino de la suscripción. Como parte del proceso de restauración, este cmdlet almacena los discos y la información de configuración de esta cuenta de almacenamiento.

Tipo:	String
Posición:	2
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetFileShareName

Recurso compartido de archivos al que se debe restaurar el recurso compartido de archivos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetFolder

Carpeta en la que se debe restaurar el recurso compartido de archivos en dentro de TargetFileShareName. Si el contenido de la copia de seguridad debe restaurarse en una carpeta raíz, asigne los valores de la carpeta de destino como una cadena vacía.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetResourceGroupName

Grupo de recursos al cual se van a restaurar los discos administrados. Aplicable a la copia de seguridad de la máquina virtual con discos administrados

Tipo:	String
Posición:	3
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetStorageAccountName

Cuenta de almacenamiento a la que se debe restaurar el recurso compartido de archivos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetSubnetName

Nombre de la subred en la que se debe crear la máquina virtual de destino, en el caso de restauración de ubicación alternativa en una nueva máquina virtual

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetSubscriptionId

Identificador de la suscripción de destino a la que se debe restaurar el recurso. Use este parámetro para la restauración entre suscripciones

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetVMName

Nombre de la máquina virtual a la que se deben restaurar los datos, en el caso de restauración de ubicación alternativa en una nueva máquina virtual

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetVNetName

Nombre de la red virtual en la que se debe crear la máquina virtual de destino, en el caso de restauración de ubicación alternativa en una nueva máquina virtual

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetVNetResourceGroup

Nombre del grupo de recursos que contiene la red virtual de destino, en el caso de restauración de ubicación alternativa en una nueva máquina virtual

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TargetZoneNumber

Número de zona de disponibilidad de destino donde se anclan los discos restaurados.

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Token

Parámetro para autorizar las operaciones protegidas por protección de recursos entre inquilinos. Use el comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token para capturar el token de autorización para un inquilino diferente

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseOriginalStorageAccount

Use este modificador si los discos del punto de recuperación se van a restaurar a sus cuentas de almacenamiento originales.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserAssignedIdentityId

UserAssigned Identity Id para desencadenar la restauración basada en MSI con UserAssigned Identity

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseSystemAssignedIdentity

Use este modificador para desencadenar la restauración basada en MSI con SystemAssigned Identity

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VaultId

Id. de ARM del almacén de Recovery Services.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-VaultLocation

Ubicación del almacén de Recovery Services.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WLRecoveryConfig

Configuración de recuperación

Tipo:	RecoveryConfigBase
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

String

RecoveryPointBase

Salidas

JobBase

Vínculos relacionados

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