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

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

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

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

■名前

Set-AzureStorSimpleDevice

■概要

デバイスに対するデバイス構成を変更します。

■構文

■説明

Set-AzureStorSimpleDevice コマンドレットは、デバイスに対するデバイス構成を変更します。初めてデバイスを設定する場合、-TimeZone、-SecondaryDnsServer、および StorSimpleNetworkConfig パラメーターを指定する必要があります。controller0、controller1、および IP アドレスを持つ Data0 に対するネットワーク構成を含む必要があります。初めてデバイスを構成するには、少なくとも インターネット SCSI (iSCSI) 有効ネットワーク インターフェイスが必要です。

■パラメーター

-DeviceId <String>
構成する StorSimple デバイスのインスタンス ID を指定します。

-DeviceName <String>
構成する StorSimple デバイスのフレンドリ名を指定します。

-NewName [<String>]
StorSimple デバイスの新しいフレンドリ名を指定します。

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

-SecondaryDnsServer [<String>]
StorSimple デバイスに対するセカンダリ DNS サーバーを指定します。

-StorSimpleNetworkConfig [<NetworkConfig[]>]
デバイス上のインターフェイスに対するネットワーク構成オブジェクトの配列を指定します。NetworkConfig オブジェクトを取得するために、New-AzureStorSimpleNetworkConfig コマンドレットを用います。

-TimeZone [<TimeZoneInfo>]
デバイスのタイム ゾーンを指定します。GetSystemTimeZone() メソッドを用いて TimeZoneInfo オブジェクトの作成が可能です。例として、太平洋標準時間帯のタイム ゾーン情報オブジェクトを作成します: [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq “Pacific Standard Time” }

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

■入力

• NetworkConfig, TimeZoneInfo
  このコマンドレットへ、NetworkConfig オブジェクトもしくは TimeZoneInfo オブジェクトを渡すことが可能です。

■出力

• DeviceDetails
  このコマンドレットは、仮想デバイスに対する更新されたデバイスの詳細を返します。

■メモ

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

■エイリアス

• なし

■例

例 1: デバイスに対する構成の修正

$NetworkConfigData0 = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
$TimeZoneInfo = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }
$OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
$UpdatedDetails = Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -TimeZone $TimeZoneInfo -SecondaryDnsServer 10.8.8.8 -StorSimpleNetworkConfig $NetworkConfigData0

1 番目のコマンドは、Data0 インターフェイスに対してネットワーク構成を作成します。このコマンドは、-Controller0IPv4Address、-Controller1IPv4Address、および -EnableIscsi パラメーターを指定します。コマンドは、変数 $NetworkConfigData0 内に結果を格納します。

2 番目のコマンドは、太平洋標準時間帯を取得するために System.TimeZoneInfo .NET クラスと標準構文を用いて、変数 $TimeZoneInfo 内のオブジェクトに格納します。

3 番目のコマンドは、オンライン StorSimple デバイスを取得するために Get-AzureStorSimpleDevice コマンドレット、および Where-Object コマンドレットを用いて変数 $OnlineDevice 内に格納します。

最後のコマンドは、指定したデバイス ID を持つデバイスの構成を修正します。コマンドは、現在のコマンドレットが 1 番目のコマンドで作成された構成オブジェクトを用います。コマンドは $TimeZoneInfo に格納されたタイム ゾーンを用います。

例 2: デバイスを修正するために構成オブジェクトをパイプ

$TimeZoneInfo = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }
$OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
$UpdatedDetails = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49" | Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -TimeZone $TimeZoneInfo -SecondaryDnsServer 10.8.8.8

この例は、最後のコマンドでパイプライン操作を用いて現在のコマンドレットへネットワーク構成オブジェクトを渡すことを除いて、例 1 と同じ構成の更新を行います。

例 3: デバイスを修正するためにタイム ゾーン オブジェクトのパイプ

$NetworkConfigData0 = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
$OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
$UpdatedDetails = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" } | Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -SecondaryDnsServer 10.8.8.8 -StorSimpleNetworkConfig $NetworkConfigData0

この例は、最後のコマンドでパイプライン操作を用いて現在のコマンドレットにタイムゾーン オブジェクトを渡すことを除いて、例 1 と同じ構成の更新を行います。

■関連するトピック

• New-AzureStorSimpleNetworkConfig
• Set-AzureStorSimpleVirtualDevice

[参考]

• Set-AzureStorSimpleDevice
  https://msdn.microsoft.com/ja-jp/library/dn708660.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