Share via


Remove-AzureStorSimpleDeviceBackup

Tar bort ett säkerhetskopieringsobjekt.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

Syntax

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

Description

Cmdleten Remove-AzureStorSimpleDeviceBackup tar bort ett enda säkerhetskopieringsobjekt. Om du försöker ta bort en säkerhetskopia som redan har tagits bort returnerar den här cmdleten ett fel.

Exempel

Exempel 1: Ta bort en säkerhetskopia för en enhet

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

Det här kommandot tar bort den säkerhetskopia som har det angivna ID:t för enheten med namnet Contoso63-AppVm. Kommandot startar åtgärden som tar bort säkerhetskopieringsobjektet och returnerar sedan ett TaskResponse-objekt. Om du vill se status för uppgiften använder du cmdleten Get-AzureStorSimpleTask .

Exempel 2: Ta bort den första säkerhetskopian för en enhet med hjälp av dess 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

Det första kommandot hämtar säkerhetskopiorna för enheten med namnet Contoso63-AppVm och lagrar dem sedan i variabeln $Backup.

Det andra kommandot tar bort en säkerhetskopia från enheten med namnet Contoso63-AppVm. Kommandot använder standardpunktskommentation för att referera till egenskapen InstanceId för det första elementet i $Backup matris. Det här kommandot anger parametern WaitForComplete och därför väntar kommandot tills åtgärden har slutförts och returnerar sedan ett TaskStatusInfo-objekt .

Exempel 3: Ta bort den första säkerhetskopian för en enhet med hjälp av pipelinen

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

Det första kommandot hämtar säkerhetskopiorna för enheten med namnet Contoso63-AppVm och lagrar dem sedan i variabeln $Backup.

Det andra kommandot skickar det första objektet som lagras i $Backup matrisen till den aktuella cmdleten. Den cmdleten tar bort säkerhetskopian från enheten med namnet Contoso63-AppVm. Det här kommandot anger parametern WaitForComplete och därför väntar kommandot tills åtgärden har slutförts och returnerar sedan ett TaskStatusInfo-objekt .

Parametrar

-Backup

Anger säkerhetskopieringsobjektet som ska tas bort. Om du vill hämta ett säkerhetskopieringsobjekt använder du cmdleten Get-AzureStorSimpleDeviceBackup .

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

-BackupId

Anger instans-ID för en säkerhetskopia som ska tas bort.

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

-DeviceName

Anger namnet på den StorSimple-enhet som du vill ta bort en säkerhetskopia på.

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

-Force

Anger att den här cmdleten inte uppmanar dig att bekräfta.

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

-Profile

Anger en Azure-profil.

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

-WaitForComplete

Anger att den här cmdleten väntar på att åtgärden ska slutföras innan den returnerar kontrollen till Windows PowerShell-konsolen.

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

Indata

Backup

Utdata

TaskStatusInfo, TaskResponse

Den här cmdleten returnerar ett TaskStatusInfo-objekt om du anger parametern WaitForComplete Om du inte anger parametern returneras ett TaskResponse-objekt .