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

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

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

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

■名前

New-AzureStorSimpleDeviceVolumeContainer

■概要

ボリュームコンテナーを作成します。

■構文

New-AzureStorSimpleDeviceVolumeContainer [-DeviceName] <String> [-VolumeContainerName] <String> [-PrimaryStorageAccountCredential] <StorageAccountCredentialResponse> [-BandWidthRateInMbps] <System.Int32> [[-EncryptionEnabled] [<Boolean>]] [[-EncryptionKey] [<String>]] [[-WaitForComplete]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

■説明

New-AzureStorSimpleDeviceVolumeContainer コマンドレットは、ボリュームコンテナーを作成します。新しいボリュームコンテナーにストレージアカウント資格情報を関連付ける必要があります。ストレージアカウント資格情報を取得するために、Get-AzureStorSimpleStorageAccountCredential コマンドレットを用います。

■パラメーター

-BandWidthRateInMbps <System.Int32>
Mbit/sec (Mbps) の帯域幅率を指定します。

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

-DeviceName <String>
ボリュームコンテナーを作成する StorSimple デバイス名を指定します。

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

-EncryptionEnabled [<Boolean>]
暗号化を有効にするかどうかを示します。

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

-EncryptionKey [<String>]
暗号化キーを指定します。

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

-PrimaryStorageAccountCredential <StorageAccountCredentialResponse>
新しいボリュームコンテナーを関連付けるために StorageAccountCredential オブジェクトとして資格情報を指定します。StorageAccountCredential オブジェクトを取得するために、Get-AzureStorSimpleStorageAccountCredential コマンドレットを用います。

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

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

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

-VolumeContainerName <String>
作成するボリュームコンテナー名を指定します。

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

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

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

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

■入力

StorageAccountCredential
このコマンドレットは、ボリュームコンテナーを関連付けるために PrimaryStorageAccountCredential オブジェクトを受け入れます。

■出力

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

■メモ

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

■エイリアス

なし

■例

例 1: コンテナーの作成

 Get-AzureStorSimpleStorageAccountCredential -StorageAccountName "ContosoAccount" | New-AzureStorSimpleDeviceVolumeContainer -DeviceName "Contoso63-AppVm" -VolumeContainerName "Container08" -BandWidthRateInMbps 256

VERBOSE: ClientRequestId: 96a4ccd4-f2a9-4820-8bc8-e6b7b56dce0d_PS
VERBOSE: ClientRequestId: 90be20db-098a-4f2b-a6da-9da6f533a846_PS
VERBOSE: ClientRequestId: 410fd33a-8fa3-4ae5-a1bf-1b6da9b34ffc_PS
VERBOSE: Storage Access Credential with name ContosoAccount found!
VERBOSE: ClientRequestId: 0a6d1008-ba1f-43b2-a424-9c86be2fb83b_PS
VERBOSE: ClientRequestId: 08f0d657-a130-4a25-8090-270c58b479dc_PS
VERBOSE: ClientRequestId: 0f3e894a-b031-467c-a258-41b74c89cf18_PS
5b192120-9df0-40ed-b75e-b4e728bd37ef
VERBOSE: The create task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
5b192120-9df0-40ed-b75e-b4e728bd37ef for tracking the task’s status

Get-AzureStorSimpleStorageAccountCredential コマンドレットを用いてアカウント名「ContosoAccount」に対するストレージアカウント資格情報を取得します。コマンドは、パイプライン操作を用いて現在のコマンドレットへ資格情報を渡します。このコマンドレットは、デバイス名「Contoso63-AppVm」上のコンテナー名「Container08」を作成するためのコマンドレットから資格情報を用います。このコマンドはジョブを開始し、TaskResponse オブジェクトを返します。ジョブの状態を確認するために、Get-AzureStorSimpleTask コマンドレットを用います。