StorSimple は、Microsoft 社が提供するハイブリッドのクラウド ストレージ サービスです。 Microsoft Azure と組み合わせることで、Azure ストレージを拡張領域として利用することが可能であり、また別拠点でのデータ復旧が可能であることから、効率的なデータ管理、災害対策が実現できます。
Azure StorSimple デバイスの管理に使用することが可能な PowerShell コマンドレットが提供されており、設定方法について MSDN サイト上で公開されていますが、PowerShell コマンドレットのヘルプについては英語のみであり、日本語による情報はほとんど公開されていません。
Azure StorSimple 関連の PowerShell コマンドレットの 1 つである「Remove-AzureStorSimpleAccessControlRecord」について、本ブログにて日本語の情報として纏めてみました((他の PowerShell コマンドレットについては、「Azure StorSimple 関連の PowerShell コマンドレットについて」を参照) (Windows Azure PowerShell バージョン 0.9.7 で確認しているものとなります)。
■名前
Remove-AzureStorSimpleAccessControlRecord
■概要
サービス構成からアクセス制御レコードを削除します。
■構文
Remove-AzureStorSimpleAccessControlRecord [-ACR] <AccessControlRecord> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]
Remove-AzureStorSimpleAccessControlRecord [-ACRName] <String> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>] |
■説明
Remove-AzureStorSimpleAccessControlRecord コマンドレットは、サービス構成からアクセス制御レコードを削除します。
■パラメーター
-ACR <AccessControlRecord>
削除する AccessControlRecord を指定します。AccessControlRecord オブジェクトを取得するために、Get-AzureStorSimpleAccessControlRecord コマンドレットを用います。
必須 | true |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | true(ByValue) |
ワイルドカード文字を許可する | false |
-ACRName <String>
削除するアクセス制御レコード名を指定します。
必須 | true |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Force [<SwitchParameter>]
このコマンドレットは、確認のプロンプトを表示しないことを示します。
必須 | false |
位置 | 3 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]
Azure プロファイルを指定します。
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-WaitForComplete [<SwitchParameter>]
Windows PowerShell コンソールに制御を返す前に、このコマンドレットが完了するための操作に対して待機するかを示します。
必須 | false |
位置 | 2 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: –Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。
■入力
- AccessControlRecord
このコマンドレットは、AccessControlRecord オブジェクトを受け入れます。AccessControlRecord オブジェクトは以下のフィールドを含みます: - GlobalId (String)
- InitiatorName (String)
- InstanceId (String)
- Name (String)
- OperationInProgress (OperationInProgress)
- VolumeCount (int)
■出力
- TaskStatusInfo, TaskResponse
このコマンドレットは、-WaitForComplete パラメーターが指定されていない場合、TaskStatusInfo オブジェクトを返します。このパラメーターが指定されていない場合、TaskResponse オブジェクトを返します。
■メモ
- 詳細については、「Get-Help Remove-AzureStorSimpleAccessControlRecord -detailed」と入力してください。
- 技術情報については、「Get-Help Remove-AzureStorSimpleAccessControlRecord -full」と入力してください。
■エイリアス
- なし
■例
例 1: アクセス コントロール レコードの削除
Remove-AzureStorSimpleAccessControlRecord -ACRName "Acr10" -WaitForComplete -Force
VERBOSE: ClientRequestId: 574aeb7f-fbc9-46d5-bc68-1bfe4487bd8b_PS VERBOSE: ClientRequestId: 985afe84-ef95-47cb-8c8f-df094530334b_PS VERBOSE: About to run a job to remove your ACR! VERBOSE: ClientRequestId: 7eb7e1a0-2288-44da-b64c-5bf86a6b9aaf_PS JobId : f7934db5-8363-4152-b38e-b9a5d91f97b9 VERBOSE: The job created for your delete operation has completed successfully. |
このコマンドは、アクセス コントロール レコード名「Acr10」を削除します。このコマンドレットは、-WaitForComplete パラメーターを指定されているため、操作が完了するまでコマンドは待機し、TaskStatusInfo オブジェクトを返します。
例 2: パイプライン アクセス制御を用いたアクセス コントロール レコードの削除
Get-AzureStorSimpleAccessControlRecord -ACRName "Acr10" | Remove-AzureStorSimpleAccessControlRecord -Force
VERBOSE: ClientRequestId: ff8d8bd6-4c92-4ab6-8fde-e9344a253da3_PS VERBOSE: ClientRequestId: f71c74f3-33b9-40d1-b8d5-12363e98412f_PS VERBOSE: ClientRequestId: d5d809d0-ec22-4e45-97ee-a56edc41e503_PS VERBOSE: About to create a job to remove your ACR! VERBOSE: ClientRequestId: 6ffa6bc8-37b3-49ff-bafc-721b360f09cb_PS 294a0208-a43f-4d80-b824-2319cd77c5e6 VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId 294a0208-a43f-4d80-b824-2319cd77c5e6 for tracking the task’s status |
このコマンドは、アクセス コントロール レコード名「Acr10」を取得するために、Get-AzureStorSimpleAccessControlRecord コマンドレットを用いて、パイプライン操作を用いて現在のコマンドにオブジェクトを渡します。コマンドは、AccessControlRecord オブジェクトを削除する操作を開始し、TaskResponse オブジェクトを返します。タスクの状態を確認するには、Get-AzureStorSimpleTask コマンドレットを用います。
■関連するトピック
- Get-AzureStorSimpleAccessControlRecord
- New-AzureStorSimpleAccessControlRecord
- Set-AzureStorSimpleAccessControlRecord
- Get-AzureStorSimpleJob
[参考]
- Remove-AzureStorSimpleAccessControlRecord
https://msdn.microsoft.com/ja-jp/library/dn920428.aspx - Azure StorSimple Cmdlets
https://msdn.microsoft.com/ja-jp/library/dn920427.aspx - ハイブリッド クラウド ストレージによるコストおよびデータ保護の最適化 | StorSimple | マイクロソフト
http://www.microsoft.com/ja-jp/server-cloud/products/storsimple/explore.aspx - StorSimple
https://msdn.microsoft.com/ja-jp/library/azure/Dn772442.aspx