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

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

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

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

■名前

Set-AzureStorSimpleAccessControlRecord

■概要

アクセス制御レコードの IQN を更新します。

■構文

Set-AzureStorSimpleAccessControlRecord [-ACRName] <String> [-IQNInitiatorName] <String> [[-WaitForComplete]] [[-NewName] [<System.String>]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

■説明

Set-AzureStorSimpleAccessControlRecord コマンドレットは、存在するアクセス制御レコードの IQN (iSCSI qualified name) を更新します。

■パラメーター

-ACRName <String>
修正するアクセス制御レコードの名前を指定します。

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

-IQNInitiatorName <String>
このコマンドレットは、ボリュームに対するアクセスを提供する iSCSI イニシエーターの IQN を指定します。

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

-NewName [<System.String>]
アクセス制御レコードに対する新しい名前を指定します。

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

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

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

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

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

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

■入力

なし

■出力

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

■メモ

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

■エイリアス

なし

■例

例 1: アクセス制御レコードの更新

 Set-AzureStorSimpleAccessControlRecord -ACRName "Acr10" -IQNInitiatorName "IqnUpdated" -WaitForComplete

VERBOSE: ClientRequestId: e4766335-f302-40e0-93bf-fad7aa488ae6_PS
VERBOSE: ClientRequestId: cfdbbd67-6ba5-4238-b743-b88f604079b9_PS
VERBOSE: About to run a task to update your Access Control Record!
VERBOSE: ClientRequestId: d5cf2793-0ab5-40ff-ab6f-43e21bc4c0a4_PS

JobId        : 89502523-52fc-4ce2-b2d4-cb8c6692fb60
JobResult    : Succeeded
JobStatus    : Completed
ErrorCode    :
ErrorMessage :
JobSteps     : {}

VERBOSE: The job created for your update operation has completed successfully.
VERBOSE: ClientRequestId: cbd47519-3a3c-4365-b097-0fb7551c48ee_PS
GlobalId            :
InitiatorName       : IqnUpdated
InstanceId          : 9bcfbc83-e196-4688-9016-827f51515c24
Name                : Acr10
OperationInProgress : None
VolumeCount         : 0

このコマンドは、iSCSI イニシエーター「IqnUpdated」に対するアクセス制御レコード「Acr10」を更新します。このコマンドは、-WaitForComplete パラメーターを指定しているため、コマンドは操作が完了するまで待機し、TaskStatusInfo オブジェクトを返します。