Remove-AzureStorSimpleDeviceBackup
Usuwa obiekt kopii zapasowej.
Uwaga
Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
Składnia
Remove-AzureStorSimpleDeviceBackup
-DeviceName <String>
-BackupId <String>
[-Force]
[-WaitForComplete]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Remove-AzureStorSimpleDeviceBackup
-DeviceName <String>
-Backup <Backup>
[-Force]
[-WaitForComplete]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-AzureStorSimpleDeviceBackup usuwa pojedynczy obiekt kopii zapasowej. Jeśli spróbujesz usunąć kopię zapasową, która została już usunięta, to polecenie cmdlet zwróci błąd.
Przykłady
Przykład 1. Usuwanie kopii zapasowej urządzenia
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
To polecenie usuwa kopię zapasową, która ma określony identyfikator urządzenia o nazwie Contoso63-AppVm. Polecenie uruchamia operację, która usuwa obiekt Backup , a następnie zwraca obiekt TaskResponse . Aby wyświetlić stan zadania, użyj polecenia cmdlet Get-AzureStorSimpleTask .
Przykład 2: Usuwanie pierwszej kopii zapasowej urządzenia przy użyciu jego identyfikatora
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
Pierwsze polecenie pobiera kopie zapasowe urządzenia o nazwie Contoso63-AppVm, a następnie zapisuje je w zmiennej $Backup.
Drugie polecenie usuwa kopię zapasową z urządzenia o nazwie Contoso63-AppVm. Polecenie używa standardowej notacji kropkowej, aby odwołać się do właściwości InstanceId pierwszego elementu tablicy $Backup. To polecenie określa parametr WaitForComplete , a zatem polecenie czeka na zakończenie operacji, a następnie zwraca obiekt TaskStatusInfo .
Przykład 3. Usuwanie pierwszej kopii zapasowej urządzenia przy użyciu potoku
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
Pierwsze polecenie pobiera kopie zapasowe urządzenia o nazwie Contoso63-AppVm, a następnie zapisuje je w zmiennej $Backup.
Drugie polecenie przekazuje pierwszy obiekt przechowywany w tablicy $Backup do bieżącego polecenia cmdlet. To polecenie cmdlet usuwa kopię zapasową z urządzenia o nazwie Contoso63-AppVm. To polecenie określa parametr WaitForComplete , a zatem polecenie czeka na zakończenie operacji, a następnie zwraca obiekt TaskStatusInfo .
Parametry
-Backup
Określa obiekt Backup do usunięcia. Aby uzyskać obiekt Backup , użyj polecenia cmdlet Get-AzureStorSimpleDeviceBackup .
Typ: | Backup |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-BackupId
Określa identyfikator wystąpienia kopii zapasowej do usunięcia.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DeviceName
Określa nazwę urządzenia StorSimple, na którym ma zostać usunięta kopia zapasowa.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Force
Wskazuje, że to polecenie cmdlet nie wyświetla monitu o potwierdzenie.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Profile
Określa profil platformy Azure.
Typ: | AzureSMProfile |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WaitForComplete
Wskazuje, że to polecenie cmdlet oczekuje na ukończenie operacji przed zwróceniem kontrolki do konsoli programu Windows PowerShell.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Backup
Dane wyjściowe
TaskStatusInfo, TaskResponse
To polecenie cmdlet zwraca obiekt TaskStatusInfo , jeśli określisz parametr WaitForComplete Jeśli nie określisz tego parametru, zwraca obiekt TaskResponse .