Delen via

Remove-AzureStorSimpleDeviceBackupPolicy

  • Referentie
Module:
Azure

Hiermee verwijdert u een bestaand back-upbeleid.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntax

Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicyId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicy <BackupPolicyDetails>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

De cmdlet Remove-AzureStorSimpleDeviceBackupPolicy verwijdert een bestaand BackupPolicy-object . Nadat u een back-upbeleid hebt verwijderd, worden er geen back-ups meer uitgevoerd op basis van dat beleid. Met deze cmdlet worden ook alle planningen verwijderd die zijn gekoppeld aan het verwijderde beleid.

Voorbeelden

Voorbeeld 1: Een back-upbeleid verwijderen

PS C:\>Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "03710b4c-82c1-40ca-be5c-40289dc49642" -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

Met deze opdracht verwijdert u de BackupPolicy met de exemplaar-id 03710b4c-82c1-40ca-be5c-40289dc49642, zodat er geen back-ups meer worden gemaakt op basis van dit beleid. Met de opdracht worden ook alle planningen verwijderd die aan dit beleid zijn gekoppeld. De opdracht start de bewerking die het BackupPolicy-object verwijdert en retourneert vervolgens een TaskResponse-object . Gebruik de cmdlet Get-AzureStorSimpleTask om de status van de taak te bekijken.

Voorbeeld 2: De eerste van het back-upbeleid voor een apparaat verwijderen

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.

De eerste opdracht haalt het back-upbeleid voor het apparaat met de naam Contoso63-AppVm op en slaat deze vervolgens op in de $Policies variabele.

Met de tweede opdracht wordt het eerste back-upbeleid verwijderd uit Contoso63-AppVm. De opdracht maakt gebruik van de standaardsyntaxis voor stippen om de eigenschap InstanceId van het eerste item in $Policies te identificeren. Met deze opdracht geeft u de parameter WaitForComplete op , dus de opdracht voltooit de taak en retourneert vervolgens een TaskStatusInfo-object voor de taak.

Voorbeeld 3: Een back-upbeleid verwijderen met behulp van de pijplijn

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!

Met deze opdracht wordt een BackupPolicyDetails-object opgehaald met behulp van Get-AzureStorSimpleDeviceBackupPolicy en wordt het vervolgens doorgegeven aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet wordt het back-upbeleid met de naam TSQAVolume01_Default verwijderd.

Parameters

-BackupPolicy

Hiermee geeft u het BackupPolicyDetails-object te verwijderen. Gebruik de cmdlet Get-AzureStorSimpleDeviceBackupPolicy om een BackupPolicyDetails-object te verkrijgen.

Type:BackupPolicyDetails
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-BackupPolicyId

Hiermee geeft u de exemplaar-id van het BackupPolicy-object dat moet worden verwijderd.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Hiermee geeft u de naam op van het StorSimple-apparaat waarop het back-upbeleid moet worden verwijderd.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Geeft aan dat deze cmdlet u niet om bevestiging vraagt.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Hiermee geeft u een Azure-profiel op.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForComplete

Geeft aan dat deze cmdlet wacht tot de bewerking is voltooid voordat het besturingselement wordt geretourneerd naar de Windows PowerShell-console.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

BackupPolicyDetails

Deze cmdlet accepteert een BackupPolicyDetails-object dat moet worden verwijderd.

Uitvoerwaarden

TaskStatusInfo, TaskResponse

Met deze cmdlet wordt een TaskStatusInfo-object geretourneerd als u de parameter WaitForComplete opgeeft. Als u die parameter niet opgeeft, wordt er een TaskResponse-object geretourneerd.