Share via

Remove-AzureStorSimpleDeviceBackupPolicy

  • リファレンス
モジュール:
Azure

既存のバックアップ ポリシーを削除します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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

説明

Remove-AzureStorSimpleDeviceBackupPolicy コマンドレットは、既存の BackupPolicy オブジェクトを削除します。 バックアップ ポリシーを削除した後、そのポリシーに基づいてそれ以上バックアップは行われません。 このコマンドレットは、削除されたポリシーに関連付けられているすべてのスケジュールも削除します。

例

例 1: バックアップ ポリシーを削除する

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

このコマンドは、インスタンス ID 03710b4c-82c1-40ca-be5c-40289dc49642 を持つ BackupPolicy を削除し、このポリシーに基づいてバックアップを作成しないようにします。 このコマンドは、このポリシーに関連付けられているすべてのスケジュールも削除します。 このコマンドは、BackupPolicy オブジェクトを削除する操作を開始し、TaskResponse オブジェクトを返します。 タスクの状態を確認するには、Get-AzureStorSimpleTask コマンドレットを使用します。

例 2: デバイスの最初のバックアップ ポリシーを削除する

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.

最初のコマンドは、Contoso63-AppVm という名前のデバイスのバックアップ ポリシーを取得し、$Policies変数に格納します。

2 番目のコマンドは、Contoso63-AppVm から最初のバックアップ ポリシーを削除します。 このコマンドでは、標準のドット構文を使用して、 $Policiesの最初の項目の InstanceId プロパティを識別します。 このコマンドは WaitForComplete パラメーターを指定するため、コマンドはタスクを完了し、タスクの TaskStatusInfo オブジェクトを返します。

例 3: パイプラインを使用してバックアップ ポリシーを削除する

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!

このコマンドは、Get-AzureStorSimpleDeviceBackupPolicy を使用して BackupPolicyDetails オブジェクトを取得し、パイプライン 演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、TSQAVolume01_Defaultという名前のバックアップ ポリシーを削除します。

パラメーター

-BackupPolicy

削除する BackupPolicyDetails オブジェクトを指定します。 BackupPolicyDetails オブジェクトを取得するには、Get-AzureStorSimpleDeviceBackupPolicy コマンドレットを使用します。

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

-BackupPolicyId

削除する BackupPolicy オブジェクトのインスタンス ID を指定します。

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

-DeviceName

バックアップ ポリシーを削除する StorSimple デバイスの名前を指定します。

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

-Force

このコマンドレットが確認を求めないことを示します。

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

-Profile

Azure プロファイルを指定します。

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

-WaitForComplete

このコマンドレットは、Windows PowerShell コンソールに制御を返す前に、操作が完了するまで待機することを示します。

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

入力

BackupPolicyDetails

このコマンドレットは、削除する BackupPolicyDetails オブジェクトを受け入れます。

出力

TaskStatusInfo, TaskResponse

WaitForComplete パラメーターを 指定すると、このコマンドレットは TaskStatusInfo オブジェクトを 返 します。 そのパラメーターを指定しない場合は、TaskResponse オブジェクトを返します。