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 コマンドレットを用います。

■関連するトピック

  • Get-AzureStorSimpleDeviceVolumeContainer
  • Remove-AzureStorSimpleDeviceVolumeContainer
  • Get-AzureStorSimpleStorageAccountCredential
  • Get-AzureStorSimpleJob

[参考]