Partager via


Restore-AzStorageBlobRange

Restaure un compte de stockage pour des plages d’objets blob spécifiques.

Syntaxe

Restore-AzStorageBlobRange
       [-ResourceGroupName] <String>
       [-StorageAccountName] <String>
       -TimeToRestore <DateTime>
       [-BlobRestoreRange <PSBlobRestoreRange[]>]
       [-WaitForComplete]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzStorageBlobRange
       [-ResourceId] <String>
       -TimeToRestore <DateTime>
       [-BlobRestoreRange <PSBlobRestoreRange[]>]
       [-WaitForComplete]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzStorageBlobRange
       -StorageAccount <PSStorageAccount>
       -TimeToRestore <DateTime>
       [-BlobRestoreRange <PSBlobRestoreRange[]>]
       [-WaitForComplete]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet de commande Restore-AzStorageBlobRange restaure les objets blob dans un compte de stockage pour des plages d’objets blob spécifiques. La plage de début est incluse et la plage de fin est exclue dans la restauration d’objets blob.

Exemples

Exemple 1 : Démarrer la restauration d’objets blob dans un compte de stockage avec des plages d’objets blob spécifiques

$range1 = New-AzStorageBlobRangeToRestore -StartRange container1/blob1 -EndRange container2/blob2
$range2 = New-AzStorageBlobRangeToRestore -StartRange container3/blob3 -EndRange container4/blob4
Restore-AzStorageBlobRange -ResourceGroupName "myresourcegoup" -StorageAccountName "mystorageaccount" -TimeToRestore (Get-Date).AddDays(-1) -BlobRestoreRange $range1,$range2

Status     RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges                     
------     ---------                            ------------- ------------------------     ---------------------                     
InProgress 6ca55a8b-fca0-461a-8e4c-13927a9707e6               2020-02-10T13:58:44.6841810Z ["container1/blob1" -> "container2/blob2",...]

(Get-AzStorageAccount -ResourceGroupName $rgname -StorageAccountName $accountName -IncludeBlobRestoreStatus).BlobRestoreStatus 

Status   RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges                     
------   ---------                            ------------- ------------------------     ---------------------                     
Complete 6ca55a8b-fca0-461a-8e4c-13927a9707e6               2020-02-10T13:58:44.6841810Z ["container1/blob1" -> "container2/blob2",...]

Cette commande crée d’abord 2 plages d’objets blob, puis démarre les restaurations d’objets blob dans un compte de stockage avec les 2 plages d’objets blob de 1 jour. L’utilisateur peut utiliser Get-AzStorageAccount pour suivre l’état de restauration ultérieurement.

Exemple 2 : Restaure tous les objets blob d’un compte de stockage dans le back-end

$job = Restore-AzStorageBlobRange -ResourceGroupName "myresourcegoup" -StorageAccountName "mystorageaccount" -TimeToRestore (Get-Date).AddMinutes(-30) -WaitForComplete -asjob

$job | Wait-Job

$job.Output

Status   RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges
------   ---------                            ------------- ------------------------     ---------------------
Complete 0387953a-bbe6-4602-818d-e661581ee44b               2020-08-28T07:11:33.9843100Z ["" -> ""]

Cette commande restaure tous les objets blob d’un compte de stockage il y a 30 minutes et attend la fin de la restauration. Étant donné que les objets blob de restauration peuvent prendre beaucoup de temps, exécutez-le dans le back-end avec le paramètre -Asjob, puis attendez la fin du travail et affichez le résultat.

Exemple 3 : Restaure les objets blob par plages d’objets blob d’entrée directement et attendez la fin

Restore-AzStorageBlobRange -ResourceGroupName "myresourcegoup" -StorageAccountName "mystorageaccount" -WaitForComplete `
    -TimeToRestore (Get-Date).AddSeconds(-1) `
    -BlobRestoreRange @{StartRange="aaa/abc";EndRange="bbb/abc"},@{StartRange="bbb/acc";EndRange=""}

WARNING: Restore blob rang with Id 'd66d1d02-6e48-47ef-b516-0155dd8319c6' started. Restore blob ranges time to complete is dependent on the size of the restore.

Status   RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges   
------   ---------                            ------------- ------------------------     ---------------------   
Complete d66d1d02-6e48-47ef-b516-0155dd8319c6               2020-02-10T14:17:46.8189116Z ["aaa/abc" -> "bbb/abc",...]

Cette commande restaure les objets blob dans un compte de stockage il y a 1 jour, en entrant 2 plages d’objets blob directement dans l’applet de commande Restore-AzStorageBlobRange. Cette commande attend la fin de la restauration.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

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

-BlobRestoreRange

Plage d’objets blob à restaurer. Si ce paramètre n’est pas spécifié, restaure tous les objets blob.

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

-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

-ResourceGroupName

Nom du groupe de ressources.

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

-ResourceId

ID de ressource du compte de stockage.

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

-StorageAccount

Objet compte de stockage

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

-StorageAccountName

Nom du compte de stockage.

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

-TimeToRestore

Durée de restauration de l’objet blob.

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

-WaitForComplete

Attendez la fin de la tâche de restauration

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

PSStorageAccount

Sorties

PSBlobRestoreStatus