Compartir a través de

Remove-AzureStorSimpleDeviceBackup

  • Referencia
Módulo:
Azure

Elimina un objeto de copia de seguridad.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

Description

El cmdlet Remove-AzureStorSimpleDeviceBackup elimina un único objeto de copia de seguridad. Si intenta eliminar una copia de seguridad que ya se ha eliminado, este cmdlet devuelve un error.

Ejemplos

Ejemplo 1: Quitar una copia de seguridad de un dispositivo

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

Este comando quita la copia de seguridad que tiene el identificador especificado para el dispositivo denominado Contoso63-AppVm. El comando inicia la operación que quita el objeto Backup y, a continuación, devuelve un objeto TaskResponse . Para ver el estado de la tarea, use el cmdlet Get-AzureStorSimpleTask .

Ejemplo 2: Quitar la primera copia de seguridad de un dispositivo mediante su identificador

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

El primer comando obtiene las copias de seguridad del dispositivo denominado Contoso63-AppVm y, a continuación, los almacena en la variable $Backup.

El segundo comando elimina una copia de seguridad del dispositivo denominado Contoso63-AppVm. El comando usa la notación de puntos estándar para hacer referencia a la propiedad InstanceId del primer elemento de la matriz $Backup. Este comando especifica el parámetro WaitForComplete y, por tanto, el comando espera hasta que se complete la operación y, a continuación, devuelve un objeto TaskStatusInfo .

Ejemplo 3: Eliminación de la primera copia de seguridad de un dispositivo mediante la canalización

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

El primer comando obtiene las copias de seguridad del dispositivo denominado Contoso63-AppVm y, a continuación, los almacena en la variable $Backup.

El segundo comando pasa el primer objeto almacenado en la matriz $Backup al cmdlet actual. Ese cmdlet elimina esa copia de seguridad del dispositivo denominado Contoso63-AppVm. Este comando especifica el parámetro WaitForComplete y, por tanto, el comando espera hasta que se complete la operación y, a continuación, devuelve un objeto TaskStatusInfo .

Parámetros

-Backup

Especifica el objeto Backup que se va a eliminar. Para obtener un objeto Backup , use el cmdlet Get-AzureStorSimpleDeviceBackup .

Tipo:Backup
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-BackupId

Especifica el identificador de instancia de una copia de seguridad que se va a eliminar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeviceName

Especifica el nombre del dispositivo StorSimple en el que se va a eliminar una copia de seguridad.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Indica que este cmdlet no le pide confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica un perfil de Azure.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WaitForComplete

Indica que este cmdlet espera a que se complete la operación antes de devolver el control a la consola de Windows PowerShell.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Backup

Salidas

TaskStatusInfo, TaskResponse

Este cmdlet devuelve un objeto TaskStatusInfo si especifica el parámetro WaitForComplete Si no especifica ese parámetro, devuelve un objeto TaskResponse .