Remove-AzureStorSimpleDeviceBackupPolicy

  • Referencia
Módulo:
Azure

Quita una directiva de copia de seguridad existente.

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-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicyId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicy <BackupPolicyDetails>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

El cmdlet Remove-AzureStorSimpleDeviceBackupPolicy quita un objeto BackupPolicy existente. Después de quitar una directiva de copia de seguridad, no se realizan más copias de seguridad en función de esa directiva. Este cmdlet también elimina todas las programaciones asociadas a la directiva eliminada.

Ejemplos

Ejemplo 1: Eliminación de una directiva de copia de seguridad

PS C:\>Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -Force
VERBOSE: ClientRequestId: b3e4d485-eae4-4cf4-a43b-815f3abcd2dd_PS
VERBOSE: ClientRequestId: a260ee98-46aa-49e0-91ac-31d4155f4cae_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: 92a9c264-90df-4345-a495-92767dd266f2_PS
695be190-ac81-4cf2-b1c5-03ef6b08d005
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
695be190-ac81-4cf2-b1c5-03ef6b08d005 for tracking the task's status

Este comando quita backupPolicy que tiene el identificador de instancia 00001111-aaaa-2222-bbbb-3333cc4444, de modo que no se realicen más copias de seguridad basadas en esta directiva. El comando también elimina todas las programaciones asociadas a esta directiva. El comando inicia la operación que quita el objeto BackupPolicy 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 de las directivas de copia de seguridad de un dispositivo

PS C:\>$Policies = Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm"
PS C:\> Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId $Policies[0].InstanceId -Force -WaitForComplete
VERBOSE: ClientRequestId: db3b49fa-cffa-446d-ba52-daa6802e00f7_PS
VERBOSE: ClientRequestId: 70e2b56f-c2df-40d0-a1e5-d7a4d7e25962_PS
VERBOSE: About to run a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: f8eb3d4d-2c57-4fc9-9f40-79d0f2ea1b6a_PS


JobId        : 820a246e-54b6-41a9-bdd5-15d5daea9b0a
JobResult    : Succeeded
JobStatus    : Completed
ErrorCode    : 
ErrorMessage : 
JobSteps     : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep, 
               Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The job created for your remove operation has completed successfully.

El primer comando obtiene las directivas de copia de seguridad para el dispositivo denominado Contoso63-AppVm y, a continuación, los almacena en la variable $Policies.

El segundo comando quita la primera directiva de copia de seguridad de Contoso63-AppVm. El comando usa la sintaxis de punto estándar para identificar la propiedad InstanceId del primer elemento de $Policies. Este comando especifica el parámetro WaitForComplete , por lo que el comando completa la tarea y, a continuación, devuelve un objeto TaskStatusInfo para la tarea.

Ejemplo 3: Eliminación de una directiva de copia de seguridad mediante la canalización

PS C:\>Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyName "TSQAVolume01_Default" | Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -Force -WaitForComplete
VERBOSE: ClientRequestId: 60080fb1-2f88-4c17-bfd7-21aa73440a9c_PS
VERBOSE: ClientRequestId: 04c91121-50d7-4796-9af6-fc6a7d6b6a0e_PS
VERBOSE: ClientRequestId: 47ceb37c-672f-42e8-bd19-1190925c46cd_PS
VERBOSE: ClientRequestId: cbc39757-f2cc-4cc5-93ea-4ec0fbfb0ca8_PS
VERBOSE: ClientRequestId: 3614d47a-51fc-4500-a5f1-5401301ca4e3_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: dbd7166e-1888-4b11-9af9-8d49712a8c8b_PS
702ad240-5730-4015-b051-56055bd2c2d3
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
702ad240-5730-4015-b051-56055bd2c2d3 for tracking the task's status
VERBOSE: BackupPolicy with id bfe0bf8a-2d09-4690-93da-38a4f24e9f4f found!

Este comando obtiene un objeto BackupPolicyDetails mediante Get-AzureStorSimpleDeviceBackupPolicy y, a continuación, lo pasa al cmdlet actual mediante el operador de canalización. El cmdlet actual quita la directiva de copia de seguridad denominada TSQAVolume01_Default.

Parámetros

-BackupPolicy

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

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

-BackupPolicyId

Especifica el identificador de instancia del objeto BackupPolicy 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 eliminará la directiva de 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

BackupPolicyDetails

Este cmdlet acepta un objeto BackupPolicyDetails que se va a eliminar.

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 .