Share via

Remove-AzureStorSimpleDeviceBackup

  • Référence
Module:
Azure

Supprime un objet de sauvegarde.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Remove-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -BackupId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -Backup <Backup>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureStorSimpleDeviceBackup supprime un seul objet de sauvegarde. Si vous tentez de supprimer une sauvegarde qui a déjà été supprimée, cette applet de commande retourne une erreur.

Exemples

Exemple 1 : Supprimer une sauvegarde pour un appareil

PS C:\>Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -BackupId "dcb5c991-0485-400f-8d0a-03a1341ee989" -Force
The remove job is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId 6c73aff2-f5a1-4b5e-
9a4e-857e128dc216 for tracking the job status

Cette commande supprime la sauvegarde qui a l’ID spécifié pour l’appareil nommé Contoso63-AppVm. La commande démarre l’opération qui supprime l’objet Backup , puis retourne un objet TaskResponse . Pour afficher l’état de la tâche, utilisez l’applet de commande Get-AzureStorSimpleTask .

Exemple 2 : Supprimer la première sauvegarde d’un appareil à l’aide de son ID

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm"
PS C:\> Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -BackupId $Backup[0].InstanceId -WaitForComplete
Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 53a656c3-c082-4e1f-afb7-bff3db45c791
JobSteps   : {}
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : f4411f38d07f68b88095682dbeedd9e9

La première commande obtient les sauvegardes de l’appareil nommé Contoso63-AppVm, puis les stocke dans la variable $Backup.

La deuxième commande supprime une sauvegarde de l’appareil nommé Contoso63-AppVm. La commande utilise la notation par points standard pour faire référence à la propriété InstanceId du premier élément du tableau $Backup. Cette commande spécifie le paramètre WaitForComplete et, par conséquent, la commande attend que l’opération soit terminée, puis retourne un objet TaskStatusInfo .

Exemple 3 : Supprimer la première sauvegarde d’un appareil à l’aide du pipeline

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso-AppVm" -WaitForComplete
PS C:\> $Backup[0] | Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso-AppVm" -Force -WaitForComplete
Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 48059fd8-e355-4b91-9385-630d24f31df6
JobSteps   : {}
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : e1753f3bf68e6e44ab719436b5111e41

La première commande obtient les sauvegardes de l’appareil nommé Contoso63-AppVm, puis les stocke dans la variable $Backup.

La deuxième commande transmet le premier objet stocké dans le tableau $Backup à l’applet de commande actuelle. Cette applet de commande supprime cette sauvegarde de l’appareil nommé Contoso63-AppVm. Cette commande spécifie le paramètre WaitForComplete et, par conséquent, la commande attend que l’opération soit terminée, puis retourne un objet TaskStatusInfo .

Paramètres

-Backup

Spécifie l’objet Backup à supprimer. Pour obtenir un objet Backup , utilisez l’applet de commande Get-AzureStorSimpleDeviceBackup .

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

-BackupId

Spécifie l’ID d’instance d’une sauvegarde à supprimer.

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

-DeviceName

Spécifie le nom de l’appareil StorSimple sur lequel supprimer une sauvegarde.

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

-Force

Indique que cette applet de commande ne vous invite pas à confirmer.

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

-Profile

Spécifie un profil Azure.

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

-WaitForComplete

Indique que cette applet de commande attend la fin de l’opération avant de retourner le contrôle à la console Windows PowerShell.

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

Entrées

Backup

Sorties

TaskStatusInfo, TaskResponse

Cette applet de commande renvoie un objet TaskStatusInfo si vous spécifiez le paramètre WaitForComplete Si vous ne spécifiez pas ce paramètre, il renvoie un objet TaskResponse .