次の方法で共有

Remove-AzureStorSimpleDeviceBackupPolicy

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

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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 "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

このコマンドは、インスタンス ID 00001111-aaaa-2222-bbbb-3333cccc4444 を持つ 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 コマンドレットを使用します。

型:BackupPolicyDetails
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-BackupPolicyId

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeviceName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

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

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WaitForComplete

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

BackupPolicyDetails

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

出力

TaskStatusInfo, TaskResponse

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