Restore-AzRecoveryServicesBackupItem

Module:

Az.RecoveryServices

Restaure les données et la configuration d’un élément de sauvegarde vers le point de récupération spécifié. Les paramètres requis varient selon le type d’élément de sauvegarde. La même commande est utilisée pour restaurer des machines virtuelles Azure, des bases de données s’exécutant dans des machines virtuelles Azure et des partages de fichiers Azure.

Syntaxe

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

L’applet de commande Restore-AzRecoveryServicesBackupItem restaure les données et la configuration d’un élément Sauvegarde Azure sur un point de récupération spécifié.

Pour la sauvegarde de machine virtuelle Azure

Vous pouvez sauvegarder des machines virtuelles Azure et restaurer des disques (gérés et non managés) à l’aide de cette commande. L’opération de restauration ne restaure pas la machine virtuelle complète. S’il s’agit d’une machine virtuelle de disque managé, un groupe de ressources cible doit être spécifié où les disques restaurés sont conservés. Lorsque le groupe de ressources cible est spécifié, si les instantanés sont présents dans le groupe de ressources spécifié dans la stratégie de sauvegarde, l’opération de restauration est instantanée et les disques sont créés à partir de captures instantanées locales et conservés dans le groupe de ressources cible. Il existe également une option pour les restaurer en tant que disques non managés, mais cela tirera parti des données présentes dans le coffre Azure Recovery Services et sera donc beaucoup plus lent. La configuration de la machine virtuelle et le modèle de déploiement qui peuvent être utilisés pour créer une machine virtuelle à partir des disques restaurés seront téléchargés sur le compte de stockage spécifié. S’il s’agit d’une machine virtuelle de disque non managée, les instantanés sont présents dans le compte de stockage d’origine du disque et/ou dans le coffre Recovery Services. Si l’utilisateur offre une option permettant d’utiliser le compte de stockage d’origine pour restaurer, vous pouvez fournir une restauration instantanée. Sinon, les données sont extraites du coffre Azure Recovery Services et des disques sont créées dans le compte de stockage spécifié, ainsi que la configuration de la machine virtuelle et du modèle de déploiement.

Important

Par défaut, la sauvegarde de machine virtuelle Azure sauvegarde tous les disques. Vous pouvez sauvegarder sélectivement des disques pertinents à l’aide des paramètres exclusionList ou InclusionList pendant Enable-Backup. L’option de restauration sélective des disques n’est disponible que si un disque les a sauvegardés de manière sélective.

Pour plus d’informations, reportez-vous à différents ensembles de paramètres et texte de paramètre possibles.

Remarque

Si le paramètre -VaultId est utilisé, le paramètre -VaultLocation doit également être utilisé.

Pour la sauvegarde de partage de fichiers Azure

Vous pouvez restaurer un partage de fichiers entier ou des fichiers/dossiers spécifiques/multiples sur le partage. Vous pouvez restaurer à l’emplacement d’origine ou à un autre emplacement.

Pour les charges de travail Azure

Vous pouvez restaurer des bases de données SQL dans des machines virtuelles Azure

Exemples

Exemple 1 : Restaurer les disques d’une machine virtuelle Azure de disque managé sauvegardé à partir d’un point de récupération donné

$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

La première commande obtient le coffre Recovery Services et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde de type AzureVM, du nom « V2VM » et le stocke dans la variable $BackupItem. La troisième commande obtient la date de sept jours plus tôt, puis la stocke dans la variable $StartDate. La quatrième commande obtient la date actuelle, puis la stocke dans la variable $EndDate. La cinquième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique filtré par $StartDate et $EndDate. La dernière commande restaure tous les disques sur le groupe de ressources cible Target_RG, puis fournit les informations de configuration de la machine virtuelle et le modèle de déploiement dans le compte de stockage DestAccount dans le groupe de ressources DestRG.

Exemple 2 : Restaurer une machine virtuelle Azure managée à partir d’un point de récupération donné vers un emplacement d’origine/de remplacement

$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

La première commande obtient le coffre Recovery Services et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde de type AzureVM, du nom « V2VM » et le stocke dans la variable $BackupItem. La troisième commande obtient la date de sept jours plus tôt, puis la stocke dans la variable $StartDate. La quatrième commande obtient la date actuelle, puis la stocke dans la variable $EndDate. La cinquième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique filtré par $StartDate et $EndDate. La sixième commande déclenche une restauration d’emplacement secondaire (ALR) pour créer une machine virtuelle dans Target_RG groupe de ressources en fonction des entrées spécifiées par les paramètres TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. Sinon, si un utilisateur souhaite effectuer une restauration sur place sur la machine virtuelle sauvegardée à l’origine à l’emplacement d’origine, il peut être effectué avec la dernière commande. Évitez d’utiliser TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, Paramètres TargetSubnetName pour effectuer une restauration d’emplacement d’origine (OLR).

Exemple 3 : Restaurer les disques spécifiés d’une machine virtuelle Azure de disque managé sauvegardé à partir d’un point de récupération donné

$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

La première commande obtient le coffre Recovery Services et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde de type AzureVM, du nom « V2VM » et le stocke dans la variable $BackupItem. La troisième commande obtient la date de sept jours plus tôt, puis la stocke dans la variable $StartDate. La quatrième commande obtient la date actuelle, puis la stocke dans la variable $EndDate. La cinquième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique filtré par $StartDate et $EndDate. La sixième commande stocke la liste des disques à restaurer dans la variable restoreDiskLUN. La dernière commande restaure les disques donnés, des numéros logiques spécifiés, sur le groupe de ressources cible Target_RG, puis fournit les informations de configuration de la machine virtuelle et le modèle de déploiement dans le compte de stockage DestAccount dans le groupe de ressources DestRG.

Exemple 4 : Restaurer des disques d’une machine virtuelle managée en tant que disques non managés

$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

La première commande obtient le coffre RecoveryServices et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde, puis le stocke dans la variable $BackupItem. La troisième commande obtient la date de sept jours plus tôt, puis la stocke dans la variable $StartDate. La quatrième commande obtient la date actuelle, puis la stocke dans la variable $EndDate. La cinquième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique filtré par $StartDate et $EndDate. La sixième commande restaure les disques en tant que disques non managés.

Exemple 5 : Restaurer une machine virtuelle non managée en tant que disques non managés à l’aide du compte de stockage d’origine

$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

La première commande obtient le coffre RecoveryServices et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde, puis le stocke dans la variable $BackupItem. La troisième commande obtient la date de sept jours plus tôt, puis la stocke dans la variable $StartDate. La quatrième commande obtient la date actuelle, puis la stocke dans la variable $EndDate. La cinquième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique filtré par $StartDate et $EndDate. La sixième commande restaure les disques en tant que disques non managés sur leurs comptes de stockage d’origine

Exemple 6 : Restaurer plusieurs fichiers d’un élément 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

La première commande obtient le coffre Recovery Services et le stocke dans $vault variable. La deuxième commande obtient l’élément de sauvegarde nommé fileshareitem, puis le stocke dans la variable $BackupItem. La troisième commande obtient une liste de points de récupération pour l’élément de sauvegarde spécifique. La quatrième commande spécifie les fichiers à restaurer et les stocke dans $files variable. La dernière commande restaure les fichiers spécifiés à son emplacement d’origine.

Exemple 7 : Restaurer une base de données SQL au sein d’une machine virtuelle Azure vers une autre machine virtuelle cible pour un point de récupération complet distinct

$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

Exemple 8 : Restaurer une base de données SQL au sein d’une machine virtuelle Azure vers une autre machine virtuelle cible pour un point de récupération de journal

$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

Exemple 9 : Restauration réhydratée pour IaasVM à partir d’un point de récupération archivé

$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

Ici, nous filtrons les points de récupération présents dans le niveau VaultArchive et déclenchant une restauration avec une priorité de réhydratation et une durée de réhydratation.

Exemple 10 : Restauration zonale croisée pour une machine virtuelle non-ZonePinned dans un coffre 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

Ici, nous filtrons les points de récupération présents dans le niveau VaultStandard et déclenchant une restauration zonale croisée pour une machine virtuelle non-ZonePinned dans un coffre ZRS. Pour CZR, nous transmettons le paramètre -TargetZoneNumber. Pour la machine virtuelle non zonedPinned, CZR est pris en charge uniquement pour les coffres ZRS. Pour les machines virtuelles zonepinned, CZR est pris en charge pour les coffres ZRS et la restauration entre régions vers la région secondaire pour les coffres compatibles CRR. Nous pouvons utiliser des points de récupération de niveau instantané ou de niveau coffre pour CZR avec une limitation indiquant que le point de récupération d’instantané doit avoir plus de 4 heures.

Exemple 11 : Restauration de zone Edge pour une machine virtuelle Azure managée vers un autre emplacement

$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

Dans cet exemple, nous utilisons le paramètre RestoreToEdgeZone pour déclencher une restauration sur une nouvelle machine virtuelle de zone de périphérie à un autre emplacement. Pour la restauration d’emplacement d’origine (OLR), la restauration est implicitement une restauration de zone de périphérie si la machine virtuelle source est une machine virtuelle de zone de périphérie.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DiskEncryptionSetId

ID DES pour chiffrer les disques restaurés.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-MultipleSourceFilePath

Utilisé pour la restauration de plusieurs fichiers à partir d’un partage de fichiers. Chemins d’accès des éléments à restaurer dans le partage de fichiers.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RecoveryPoint

Spécifie le point de récupération auquel restaurer l’élément de sauvegarde. Pour obtenir un objet AzureRmRecoveryServicesBackupRecoveryPoint , utilisez l’applet de commande Get-AzRecoveryServicesBackupRecoveryPoint .

Type:	RecoveryPointBase
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RehydrateDuration

Durée en jours pendant lesquelles le point de récupération archivé est réhydraté. La valeur peut aller de 10 à 30 jours, la valeur par défaut est de 15 jours.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RehydratePriority

Priorité de réhydratation pour un point de récupération archivé lors du déclenchement de la restauration. Les valeurs acceptables sont Standard, High.

Type:	String
Valeurs acceptées:	Standard, High
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResolveConflict

Si l’élément restauré existe également dans la destination, utilisez-le pour indiquer s’il faut remplacer ou non l’élément restauré. Les valeurs valides pour ce paramètre sont :

• Remplacer
• Skip

Type:	RestoreFSResolveConflictOption
Valeurs acceptées:	Overwrite, Skip
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreAsManagedDisk

Utilisez ce commutateur pour spécifier la restauration en tant que disques managés.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreAsUnmanagedDisks

Utilisez ce commutateur pour spécifier la restauration en tant que disques non managés

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreDiskList

Spécifier les disques à récupérer de la machine virtuelle sauvegardée

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreOnlyOSDisk

Utilisez ce commutateur pour restaurer uniquement les disques de système d’exploitation d’une machine virtuelle sauvegardée

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreToEdgeZone

Changer de paramètre pour indiquer la restauration de la machine virtuelle de zone de périphérie. Ce paramètre ne peut pas être utilisé dans un scénario de restauration d’abonnement entre régions et corss

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RestoreToSecondaryRegion

Utilisez ce commutateur pour déclencher la restauration interrégion vers la région secondaire.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SourceFilePath

Utilisé pour une restauration d’élément spécifique à partir d’un partage de fichiers. Chemin d’accès de l’élément à restaurer dans le partage de fichiers.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SourceFileType

Utilisé pour une restauration d’élément spécifique à partir d’un partage de fichiers. Type de l’élément à restaurer dans le partage de fichiers. Les valeurs valides pour ce paramètre sont :

• File
• Répertoire

Type:	Nullable<T>[SourceFileType]
Valeurs acceptées:	File, Directory
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-StorageAccountName

Spécifie le nom du compte de stockage cible dans votre abonnement. Dans le cadre du processus de restauration, cette applet de commande stocke les disques et les informations de configuration dans ce compte de stockage.

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-StorageAccountResourceGroupName

Spécifie le nom du groupe de ressources qui contient le compte de stockage cible dans votre abonnement. Dans le cadre du processus de restauration, cette applet de commande stocke les disques et les informations de configuration dans ce compte de stockage.

Type:	String
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetFileShareName

Partage de fichiers vers lequel le partage de fichiers doit être restauré.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetFolder

Dossier sous lequel le partage de fichiers doit être restauré dans TargetFileShareName. Si le contenu sauvegardé doit être restauré dans le dossier racine, indiquez les valeurs du dossier cible sous forme de chaîne vide.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetResourceGroupName

Groupe de ressources vers lequel les disques managés sont restaurés. Applicable à la sauvegarde de la machine virtuelle avec des disques managés

Type:	String
Position:	3
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetStorageAccountName

Compte de stockage sur lequel le partage de fichiers doit être restauré.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetSubnetName

Nom du sous-réseau dans lequel la machine virtuelle cible doit être créée, dans le cas d’une restauration d’emplacement secondaire sur une nouvelle machine virtuelle

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetSubscriptionId

ID de l’abonnement cible auquel la ressource doit être restaurée. Utiliser ce paramètre pour la restauration entre abonnements

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetVMName

Nom de la machine virtuelle sur laquelle les données doivent être restaurées, dans le cas d’une restauration d’emplacement secondaire sur une nouvelle machine virtuelle

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetVNetName

Nom du réseau virtuel dans lequel la machine virtuelle cible doit être créée, dans le cas d’une restauration d’emplacement secondaire sur une nouvelle machine virtuelle

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetVNetResourceGroup

Nom du groupe de ressources qui contient le réseau virtuel cible, dans le cas d’une restauration d’emplacement secondaire sur une nouvelle machine virtuelle

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetZoneNumber

Numéro de zone de disponibilité cible où les disques restaurés sont épinglés.

Type:	Nullable<T>[Int32]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Token

Paramètre permettant d’autoriser les opérations protégées par la protection des ressources interlocataires. Utilisez la commande (Get-AzAccessToken -TenantId « xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx »). Jeton permettant d’extraire le jeton d’autorisation pour un locataire différent

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseOriginalStorageAccount

Utilisez ce commutateur si les disques du point de récupération doivent être restaurés sur leurs comptes de stockage d’origine.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UserAssignedIdentityId

Id d’identité UserAssigned pour déclencher la restauration basée sur MSI avec l’identité UserAssigned

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseSystemAssignedIdentity

Utilisez ce commutateur pour déclencher la restauration basée sur MSI avec SystemAssigned Identity

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-VaultId

ID ARM du coffre Recovery Services.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-VaultLocation

Emplacement du coffre Recovery Services.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de la commande cmdlet.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WLRecoveryConfig

Configuration de récupération

Type:	RecoveryConfigBase
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

Entrées

String

RecoveryPointBase

Sorties

JobBase

Liens associés

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