Azure StorSimple 関連の PowerShell コマンドレット (Start-AzureStorSimpleDeviceBackupRestoreJob) について

スポンサーリンク

StorSimple は、Microsoft 社が提供するハイブリッドのクラウド ストレージ サービスです。 Microsoft Azure と組み合わせることで、Azure ストレージを拡張領域として利用することが可能であり、また別拠点でのデータ復旧が可能であることから、効率的なデータ管理、災害対策が実現できます。

Azure StorSimple デバイスの管理に使用することが可能な PowerShell コマンドレットが提供されており、設定方法について MSDN サイト上で公開されていますが、PowerShell コマンドレットのヘルプについては英語のみであり、日本語による情報はほとんど公開されていません。

Azure StorSimple 関連の PowerShell コマンドレットの 1 つである「Start-AzureStorSimpleDeviceBackupRestoreJob」について、本ブログにて日本語の情報として纏めてみました((他の PowerShell コマンドレットについては、「Azure StorSimple 関連の PowerShell コマンドレットについて」を参照) (Windows Azure PowerShell バージョン 0.9.7 で確認しているものとなります)。

■名前

Start-AzureStorSimpleDeviceBackupRestoreJob

■概要

StorSimple デバイス上のバックアップをリストアするジョブを開始します。

■構文

Start-AzureStorSimpleDeviceBackupRestoreJob [-DeviceName] <String> [-BackupId] <String> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

Start-AzureStorSimpleDeviceBackupRestoreJob [-DeviceName] <String> [-BackupId] <String> [-SnapshotId] <String> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

■説明

Start-AzureStorSimpleDeviceBackupRestoreJob コマンドレットは、StorSimple デバイス上のバックアップをリストアするジョブを開始します。バックアップ ID および追加のスナップショット ID を指定します。

■パラメーター

-BackupId <String>
リストアするバックアップのインスタンス ID を指定します。

必須true
位置2
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-DeviceName <String>
存在するバックアップの StorSimple デバイス名を指定します。

必須true
位置1
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Force [<SwitchParameter>]
このコマンドレットが確認のプロンプトを表示しないことを示します。

必須false
位置5
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]
Azure プロファイルを指定します。

必須false
位置named
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-SnapshotId <String>
リストアするスナップショット インスタンス ID を指定します。

必須true
位置3
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-WaitForComplete [<SwitchParameter>]
Windows PowerShell コンソールに制御を返す前に、このコマンドレットが完了するための操作に対して待機するかを示します。

必須false
位置4
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: –Verbose、-Debug、-ErrorAction-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

■入力

  • なし

■出力

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

■メモ

  • 詳細については、「Get-Help Start-AzureStorSimpleDeviceBackupRestoreJob -detailed」と入力してください。
  • 技術情報については、「Get-Help Start-AzureStorSimpleDeviceBackupRestoreJob -full」と入力してください。

■エイリアス

  • なし

■例

例 1: バックアップをリストアするジョブの開始

 Start-AzureStorSimpleDeviceBackupRestoreJob -DeviceName "Contoso63-AppVm" -BackupId "b3b50534-763c-4b05-9724-5ecf62bde721" -WaitForComplete 
Confirm
Are you sure you want to restore the backup with backupId b3b50534-763c-4b05-9724-5ecf62bde721?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is “Y”): Y

Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 217d0647-c001-4f43-9833-f8155a458e95
JobSteps   : {}
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : e0aa2dcd2f197a8588c40a067fe0e519

このコマンドは、指定した ID を持つバックアップ オブジェクトをリストアするジョブを開始、デバイス名「Contoso63-AppVm」上のスナップショットに関連付けます。コマンドに -WaitForComplete パラメーターが指定されているので、コマンドレットがコンソールに制御を返す前にジョブを終了します。

例 2: 指定したスナップショットをリストアするためのジョブの開始

 Start-AzureStorSimpleDeviceBackupRestoreJob -DeviceName "Contoso63-AppVm" -BackupId "b3b50534-763c-4b05-9724-5ecf62bde721" -SnapshotId "2d0cfad7-46bf-4266-8859-96549646e947_0000000000000000" -Force 

The start job is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId 9102ed9a-078f-4648-a
721-3cffbba31336 for tracking the job status

このコマンドは、指定した ID を持つバックアップ スナップショットをリストアするジョブを開始します。コマンドにデバイス名「Contoso63-AppVm」上の ID によってバックアップ オブジェクトを指定しています。コマンドに -Force パラメーターを指定しているので、確認のプロンプトを表示しないで開始します。

■関連するトピック

  • Get-AzureStorSimpleJob
  • Start-AzureStorSimpleDeviceBackupJob

[参考]