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

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

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

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

■名前

Set-AzureStorSimpleDeviceVolume

■概要

存在するボリュームのプロパティを更新します。

■構文

Set-AzureStorSimpleDeviceVolume [-DeviceName] <System.String> [-VolumeName] <System.String> [[-Online] [<Nullable [System.Boolean]>]] [[-VolumeSizeInBytes] [<Nullable [System.Int64]>]] [[-VolumeAppType] {PrimaryVolume | ArchiveVolume}] [[-AccessControlRecords] [<System.Collections.Generic.List`1[[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord, StorSimple.Tests, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]>]] [[-WaitForComplete]] [[-NewName] [<System.String>]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

Set-AzureStorSimpleDeviceVolume [-DeviceName] <System.String> [-Volume] <Microsoft.WindowsAzure.Management.StorSimple.Models.VirtualDisk> [[-Online] [<Nullable [System.Boolean]>]] [[-VolumeSizeInBytes] [<Nullable [System.Int64]>]] [[-VolumeAppType] {PrimaryVolume | ArchiveVolume}] [[-AccessControlRecords] [<System.Collections.Generic.List`1[[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord, StorSimple.Tests, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]>]] [[-WaitForComplete]] [[-NewName] [<System.String>]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

■説明

Set-AzureStorSimpleDeviceVolume コマンドレットは、存在するボリュームのプロパティを更新します。このコマンドレットは、1 つ以上のアクセス制御レコードをボリュームに関連付けます。AccessControlRecord オブジェクトを取得するために、Get-AzureStorSimpleAccessControlRecord コマンドレットを用います、ボリュームのサイズ、もしくは型を更新します。また、ボリュームオンラインを作成するかどうか更新します。

■パラメーター

-AccessControlRecords [<System.Collections.Generic.List`1[[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord, StorSimple.Tests, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]>]
ボリュームに関連付けるアクセス制御レコードの一覧を指定します。

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

-DeviceName <System.String>
存在するボリュームを更新する StorSimple デバイス名を指定します。

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

-NewName [<System.String>]
StorSimple デバイスに対する新しい名前を指定します。

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

-Online [<Nullable [System.Boolean]>]
ボリュームがオンラインかどうかを指定します。

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

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

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

-Volume <Microsoft.WindowsAzure.Management.StorSimple.Models.VirtualDisk>
更新するボリューム名を指定します。

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

-VolumeAppType [<Nullable [Microsoft.WindowsAzure.Management.StorSimple.Models.AppType]>]
プライマリもしくはアーカイブボリュームへ更新するかどうかを指定します。有効な値: PrimaryVolume および ArchiveVolume

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

-VolumeName <System.String>
更新するボリューム名を指定します。

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

-VolumeSizeInBytes [<Nullable [System.Int64]>]
ボリュームに対するバイト内のサイズを更新します。

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

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

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

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

■入力

List<AccessControlRecord>
このコマンドレットは、ボリュームに関連付ける AccessControlRecord オブジェクトの一覧を受け入れます。

■出力

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

■メモ

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

■エイリアス

なし

■例

例 1: ボリュームに対するオンラインボリュームの更新

 Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $False

VERBOSE: ClientRequestId: f2869570-ea47-4be7-801e-9c0f22f2600d_PS
VERBOSE: ClientRequestId: c70bb86a-51d3-4390-be17-4d0847641dc3_PS
VERBOSE: ClientRequestId: d20cb5b2-6b3c-4e06-af99-cada28c5e50a_PS
VERBOSE: ClientRequestId: ab6d533e-b55b-4cfb-9c58-9153295e0547_PS
de7000f1-29c7-4102-a375-b52432f9e67e
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
de7000f1-29c7-4102-a375-b52432f9e67e for tracking the task’s status

このコマンドは、値＄False を持つボリューム名「Volume18」を更新します。このコマンドはタスクを開始し、TaskResponse オブジェクトを返します。タスクの状態を確認するには、Get-AzureStorSimpleTask コマンドレットを用います。

例 2: 値および型の修正

 Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $True -VolumeAppType ArchiveVolume

VERBOSE: ClientRequestId: af42b02a-645e-4801-a2d7-4197511c68cf_PS
VERBOSE: ClientRequestId: 7cb4f3b4-548e-42dc-a38c-0df0911c5206_PS
VERBOSE: ClientRequestId: 7cc706ad-a58f-4939-8e78-cabae8379a51_PS
VERBOSE: ClientRequestId: 6bed21d5-12fc-4a12-a89c-120bdb5636b1_PS
aa977225-af78-4c93-b754-72704afc928f
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
aa977225-af78-4c93-b754-72704afc928f for tracking the task’s status

このコマンドは、ボリューム名「Volume18」を更新します。これは型を変更し、$True へオンラインパラメーターの値を変更します。