(Reference-PSTK)Making the Most of Data ONTAP PowerShell Toolkit_jaJP_loMaking The Most Of Data...

Data ONTAP PowerShell Toolkit を最⼤限に活⽤する

はじめに

Data ONTAP PowerShell Toolkit をご利⽤いただき、ありがとうございます。ネットアップでは、

PowerShell ソリューションの改善に継続的に取り組んでいます。皆様からの貴重なご意⾒をお待ちして

おります。

Toolkit のご利⽤が初めての⽅は、Getting Started のスライドをご覧ください。⼤規模な.NET アプリケー

ションへの PowerShell の組み込みをご検討中の⽅は、C#の PowerShell 組み込み例をご覧ください。

⽬次 Data ONTAP PowerShell Toolkit を最⼤限に活⽤する ............................................................... 1

はじめに .......................................................................................................................... 1

Data ONTAP PowerShell Toolkit 2.3 .................................................................................... 6

VSS リクエスタ .............................................................................................................. 6

インストーラ ................................................................................................................. 7

SCSI XCOPY ................................................................................................................. 7

SSH の秘密鍵認証 ........................................................................................................... 8

PowerShell 3 によるクエリの簡易化 ................................................................................... 8

その他の機能強化 ........................................................................................................... 8

解決済みの問題 .............................................................................................................. 9

Data ONTAP PowerShell Toolkit 2.2 .................................................................................. 10

VHDX のサポート ......................................................................................................... 10

IPv6 のサポート ........................................................................................................... 11

clustered ONTAP 向けの Storage Efficiency 試算ツール ....................................................... 11

PowerShell Toolkit のプロキシレイヤ .............................................................................. 12

その他の機能強化 ......................................................................................................... 13

新しいコマンドレット .................................................................................................... 13

解決済みの問題 ............................................................................................................ 14


出⼒の型の固定 ............................................................................................................ 15

Snapshot からの Windows ファイルのサブ LUN クローニング ............................................... 15

Data ONTAP 8.1 への完全な対応 ..................................................................................... 15

その他の機能強化 ......................................................................................................... 16

新しいコマンドレット .................................................................................................... 16

Toolkit 2.1 の解決済みの問題 .......................................................................................... 17


clustered Data ONTAP 8.1 ............................................................................................ 18

容量可変 VHD ファイルからシンプロビジョニングされた容量固定 VHD ファイルへの変換 ............. 19

LUN から VHD ファイルへの変換 ..................................................................................... 19

VHD ファイルから LUN への変換 ..................................................................................... 19

NDMP コピークライアント ............................................................................................ 19

CIFS 共有のサポートの強化 ............................................................................................ 20

インストールスクリプト ................................................................................................ 21

その他の機能強化 ......................................................................................................... 21

新しいコマンドレット .................................................................................................... 22



V2V ユーティリティ ...................................................................................................... 23

VHD ファイルのアライメント .......................................................................................... 23


CIFS のファイルクローニング ......................................................................................... 25

クラスタ共有ボリュームのスペース再⽣ ............................................................................. 25

その他の機能強化 ......................................................................................................... 26

新しいコマンドレット .................................................................................................... 27



VHD ファイルのユーティリティ ....................................................................................... 29

スペース再⽣ ............................................................................................................... 30

Windows のディスクとボリュームの管理 ........................................................................... 31

ファイルクローニング ................................................................................................... 32

SSH のセットアップ ...................................................................................................... 32

vFiler の移⾏ ............................................................................................................... 32

対応する API の増加 ...................................................................................................... 33


その他の機能強化 ......................................................................................................... 34

新しいコマンドレット .................................................................................................... 35



Storage Efficiency 試算ツール ........................................................................................ 38

ホスト側の iSCSI および FC のユーティリティ ..................................................................... 40

ONTAP のログの解析と監視 ............................................................................................ 41

ディスクシグネチャの操作 ............................................................................................. 41

ホストディスクおよび VM の検出時間の短縮 ...................................................................... 42

vFiler DR .................................................................................................................... 43

SnapLock ................................................................................................................... 43

セキュアなパスワード処理 .............................................................................................. 43

その他の機能強化 ......................................................................................................... 44

新しいコマンドレット .................................................................................................... 44



sysstat ....................................................................................................................... 46

LUN とホストの関連付け ................................................................................................ 47

Data ONTAP のサポートの更新 ....................................................................................... 48

新しいコマンドレットのカテゴリ ..................................................................................... 48

エラー処理の強化 ......................................................................................................... 49

クォータのコマンドレットの簡易化 .................................................................................. 49

Snapshot のコマンドレットの強化 ................................................................................... 50

Get-NaHyperV でのクラスタのサポートの強化 ................................................................... 50

API ⼀覧表⽰コマンドレット ........................................................................................... 50

raw API の呼び出し ...................................................................................................... 50

オプションのハッシュ .................................................................................................... 50

プロバイダの強化 ......................................................................................................... 51

テーブルの列ヘッダーのエイリアス .................................................................................. 51

新しいコマンドレット .................................................................................................... 52



SSH の呼び出し ........................................................................................................... 54

クレデンシャルキャッシュ ............................................................................................. 54

FlexShare ................................................................................................................... 56

PowerShell プロバイダ .................................................................................................. 56

ShouldProcess ............................................................................................................ 58

ToString .................................................................................................................... 58

ソート ........................................................................................................................ 58

接続の強化 .................................................................................................................. 58

パラメータのエイリアス ................................................................................................. 59

新しいコマンドレット .................................................................................................... 59



データフォーマッタ ...................................................................................................... 60

Microsoft Hyper-V の統合 .............................................................................................. 60

ネットワークの設定 ...................................................................................................... 60

新しいコマンドレット .................................................................................................... 61


Data ONTAP PowerShell Toolkit 2.3

VSS リクエスタ Microsoft の Volume Shadow Copy Service（VSS;ボリュームシャドウコピーサービス）を利⽤する

ことで、実⾏中のアプリケーションやサービスのパフォーマンスを低下させることなく、整合性のあるボ

リュームのバックアップを作成することができます。これには、バックアップアプリケーション（VSS リ

クエスタ）、ホストアプリケーション（VSS ライター）、およびストレージシステム（VSS プロバイダ）

の連携が必要になります。Toolkit 2.3 は、ボリュームレベルのシャドウコピーを作成するための VSS リ

クエスタの基本的な機能を備えています。Data ONTAP VSS ハードウェアプロバイダをインストールす

ることを推奨します。これは SnapDrive for Windows で利⽤できます。

Toolkit 2.3 では、VSS と連携するための新しいコマンドレットとして、Get-NaVssProvider、

Get-NaVssSnapshot、Get-NaVssWriter、および Invoke-NaVssBackup の 4 つが導⼊されています。

Get-NaVssProvider では、ホストシステム上の VSS プロバイダに関する情報を取得できます。

Get-NaVssWriter では、ホストシステム上のライターに関する情報を取得できます。

Get-NaVssSnapshot では、現在のホストシステムにあるシャドウコピーに関する情報を取得できます。

Invoke-NaVssBackup では、リクエスタとして VSS と連携するための基本的なメカニズムを実装できます。Invoke-NaVssBackup はボリューム全体に対するコマンドレットであり、コンポーネントモードでは機能しません。IncludeWriter パラメータと ExcludeWriter パラメータを使⽤して、バックアップ処理に含めるライターを明⽰的に選択できます。

インストーラ Toolkit 2.3 は、適切な Windows インストーラで使⽤できる Data ONTAP PowerShell Toolkit の最初の

バージョンです。インストーラを使⽤して Toolkit をインストールしたり（ファイルを⼿動でコピーする

必要はありません）、Windows の[プログラムの追加と削除]を使⽤して Toolkit をアンインストールでき

ます。以前のバージョンの Toolkit は、インストーラを実⾏する前に削除してください。

SCSI XCOPY PowerShell Toolkit では、ファイル間のデータのコピーに、可能なかぎり WAFL ブロックのクローニン

グを使⽤します。WAFL ブロックが適切にアライメントされていないときは、Repair-

NaVirtualDiskAlignment および ConvertTo-NaVhd を使⽤して VHD を容量可変から容量固定に変

換する⽅法でデータをコピーする必要があります。これには、ホストベースのコピーが使⽤される場合が

あるため、時間がかかることがあります。

Toolkit 2.3 では、ホストベースのコピーを使⽤する必要があると⾒なされた場合、最初に SCSI XCOPY を

使⽤して Repair-NaVirtualDiskAlignment および ConvertTo-NaVhd（容量可変から容量固定への

VHD の変換）が試⾏され、SCSI XCOPY の処理に失敗した場合にかぎり、時間がかかるホストベースの

コピーが使⽤されます。

次の表は、2 つのコマンドレットの実⾏に SCSI XCOPY を使⽤した場合とホストベースのコピーを使⽤し

た場合を⽐較したものです。VHD disk0.vhd には、適切にアライメントされていない Windows 2003 仮

想マシンのブートドライブが含まれています。このディスクを ConvertTo-NaVhd で容量固定 VHD に

変換してから、Repair-NaVirtualDiskAlignment でアライメントします。

コマンド SCSI XCOPY ホストベースのコピー

ConvertTo-NaVhd –SourceVhd E:\VHD\disk0.vhd

–DestinationVhd E:\VHD\disk0_fixed.vhd

19.188 秒 1 分 10 秒

Repair-NaVirtualDiskAlignment –VirtualDisk

E:\VHD\disk0_fixed.vhd

2 分 25 秒 12 分 15 秒

この機能は Data ONTAP 8.1.1 7-Mode で使⽤できます。clustered ONTAP では、今後のリリースで提

供される予定です。

SSH の秘密鍵認証

パスワードを対話的に⼊⼒しない SSH セッションの認証には、SSH のパスワードレス処理が重要です。PowerShell Toolkit では、クレデンシャルキャッシュを使⽤してパスワードレス処理を実⾏できます。Toolkit 2.3 では、秘密鍵認証を使⽤したパスワードレス処理が導⼊されています。

SSH 接続の認証に使⽤する秘密鍵ファイルは、Invoke-NaSsh および Invoke-NcSsh の新しいパラメータである PrivateKeyFile を使⽤して指定できます。

秘密鍵認証をさらに簡易化するために、Invoke-NaSsh および Invoke-NcSsh の呼び出しごとにPrivateKeyFile パラメータを指定する代わりに、変数$DataONTAP_SSHPrivateKeyFile を設定することもできます。Invoke-NaSsh および Invoke-NcSsh では、この変数を読み取り、指定された秘密鍵ファイルを使⽤して SSH 接続を認証します。

PowerShell 3 によるクエリの簡易化 PowerShell 3 では、ハッシュテーブルからオブジェクトをインスタンス化してハイドレートするための新しいメカニズムが導⼊されています。オブジェクトで空のコンストラクタを定義し、パブリックプロパティを設定できるようにしておけば、プロパティの値を定義するハッシュテーブルを使⽤して PowerShellでオブジェクトを作成できます。たとえば、次のようにして VolumeAttributes オブジェクトを作成できます。

この⽅法は Toolkit にも影響します。たとえば、clustered ONTAP で 100GB を超えるボリュームを照会する場合について考えてみましょう。

PowerShell 3 と Toolkit 2.3 を使⽤すれば、これを 1 ⾏にまとめることができます。

さらに、より具体的な内容も 1 ⾏のコマンドで照会できます。

この機能は、Toolkit 2.3 と PowerShell 3 を使⽤した場合に利⽤できます。

その他の機能強化 Get-NaHelp および Get-NcHelp で、コマンドレットの概要が表⽰されるようになりました。

コマンドレットを⾒つけやすくするために、Get-NaCommand および Get-NcCommand という 2 つの新しいコマンドレットが追加されています。Get-NaCommand では、名前、API、カテゴリ、動詞、名詞の任意の組み合わせ（ワイルドカードも使⽤可能）で 7-Mode 向けのコマンドレットを検索できます。Get-NcCommand では、名前、API、ファミリー、カテゴリ、動詞、名詞の任意の組み合わせ（ワイルドカードも使⽤可能）で clustered ONTAP 向けのコマンドレットを検索できます。これらの Get-NaCommand と Get-NcCommand のどちらにも、現在のコントローラ（または指定したコントローラ）のコンテキストで使⽤できるコマンドレットだけに結果を絞り込む ListAvailable というスイッチがあります。ListUnavailable スイッチを使⽤すると、現在のコントローラ（または指定したコントローラ）のコンテキストで使⽤できないコマンドレットだけに結果を絞り込むことができます。

たとえば、カテゴリがアグリゲートとディスクの Get コマンドのうち、現在のコントローラのコンテキストでサポートされないコマンドをすべて取得するコマンドを次に⽰します。

Set-NaUserPassword および Set-NcUserPassword では、パスワードを変更した場合に、必要に応じて現在のコントローラ接続のクレデンシャルが⾃動的に更新されます。

vfiler-setup API を使⽤するコマンドレット（Set-NaVfilerAddress、Set-NaVfilerAdminHost、 Set-NaVfilerDns、Set-NaVfilerNis、および Set-NaVfilerPassword）に、PreserveEtcHosts スイッチと PreserveEtcExports スイッチが追加されています。vfiler-setup API では/etc/hosts ファイルおよび/etc/exports ファイルの書き換えが⾏われますが、この動作が場合によっては適さないこともあります。PreserveEtcHosts スイッチおよび PreserveEtcExports スイッチを指定すると、vFiler 上の/etc/hostsファイルと/etc/exports ファイルが vfiler-setup の実⾏前の状態に⾃動的にリストアされます。

解決済みの問題 UNC パスを指定して Set-NaVirtualDiskSize を実⾏してもエラーにならない。 –Dynamic スイッチを指定せずに New-NaVirtualDisk で作成した VHDX ファイルが、Hyper-V

では容量可変として表⽰される。 Get-NaSnapshot の出⼒の AccessTimeDT プロパティで、UTC ⽇付の DateTimeKind が Local

になる。 Remove-NaCredential および Remove-NcCredential で、クレデンシャルキャッシュにクレ

デンシャルがない場合にメッセージを表⽰せずにエラーが発⽣する。 Get-NaSystemLog で、前年の⽇付が適切に解析されないことがある。 Get-NaVol および Get-NaVol –Terse で、ボリュームが省略されることがある。


VHDX のサポート VHDX は、Windows Server 2012 で導⼊されたファイル形式です。Toolkit 2.2 では、VHDX ファイル形

式をサポートするために、VHDX ファイルを作成および変換する機能が追加されています。コマンドレッ

ト New-NaVirtualDisk を使⽤すると、初期のスペース使⽤が⾮常に少ない容量固定 VHDX ファイルを

迅速に作成できます。

New-Vhd を使⽤して 200GB の容量固定 VHDX を作成 33 分 3 秒

New-NaVirtualDisk を使⽤して 200GB の容量固定

VHDX を作成

15 秒

VHDX 仮想ディスクを作成するには、New-NaVirtualDisk コマンドレットで-VHDX という新しいスイッ

チを使⽤します。オプションの-Dynamic スイッチを使⽤すると、容量可変 VHDX ファイルを作成できま

す。このファイルはアライメントされており、ファイルが拡張されてもアライメントが維持されます。

新しいコマンドレットの ConvertTo-NaVhdx を使⽤すると、仮想ディスクを VHD、VMDK、LUN から

VHDX に変換できます。

ConvertTo-NaVhd コマンドレットで、VHDX を VHD に変換できるようになりました。

ConvertTo-NaVmdk コマンドレットで、VHDX を VMDK に変換できるようになりました。

ConvertTo-NaLun コマンドレットで、VHDX を LUN に変換できるようになりました。

IPv6 のサポート Toolkit で IPv6 がサポートされるようになりました。Connect-NaController および Connect-

NcController で、IPv6 を使⽤した Data ONTAP コントローラへの接続が可能になりました。

NDMP コピーのコマンドレットである Start-NaNdmpCopy および Invoke-NaNdmpCopy に、

-UseIpv6 という新しいスイッチが追加されています。このスイッチを指定すると、ソースとデスティネー

ションのコントローラ間の接続に IPv6 が使⽤されます。ソースとデスティネーションの両⽅のコントロー

ラで IPv6 がサポートされている必要があります。

Find-NaController および Find-NcController の-Address、-StartAddress、-EndAddress の各パラ

メータで、IPv6 アドレスを指定できるようになりました。

clustered ONTAP 向けの Storage Efficiency 試算ツール新しいコマンドレットの Get-NcEfficiency を使⽤すると、ネットアップ標準の clustered ONTAP 向け

Storage Efficiency 試算ツールを組み込むことができます。これは、Get-NaEfficiency に相当する

clustered ONTAP 向けのコマンドレットです。

Data ONTAP PowerShell のコミュニティに掲載されているスクリプトを使⽤すると、Get-NcEfficiency

の出⼒を取得して、データを Microsoft Excel にエクスポートできます。データのグラフもいくつか提供

されます。

PowerShell Toolkit のプロキシレイヤ

Toolkit 2.1 で、出⼒の型が固定され、ユーザは Toolkit がバンドルされたプロジェクトで厳密に型指定されたコードを安全に使⽤できるようになりました。Toolkit 2.2 では、Data ONTAP PowerShell Toolkitのプロキシが導⼊されています。このプロキシは、C#ソリューションで PowerShell Toolkit を使⽤する場合の PowerShell との連動を処理するライブラリです。これにより、開発者は、PowerShell ではなくソリューションの作業に集中できます。

たとえば、新しい PowerShell セッションを開始して、Data ONTAP PowerShell モジュールをロードし、コントローラに接続したあと、アグリゲート「aggr1」に「testvol」という名前の 50GB の新しいボリュームを作成するとします。

特に難しくないこの 4 つのタスクを実⾏するのに、20 ⾏のコードが必要になります。次に、同じタスクを

プロキシを使⽤して実⾏する場合について考えてみましょう。

プロキシを使⽤すると、20 ⾏必要だった処理を 3 ⾏で実⾏できます。詳細については、Data ONTAP

PowerShell のコミュニティに掲載された記事を参照してください。

その他の機能強化 Initialize-NaController は、Data ONTAP コントローラの初期設定を⾏うのに使⽤します。Toolkit 2.2

では、Data ONTAP 8.1 7-Mode との互換性が維持されるように、このコマンドレットが更新されています。

Get-NaToolkitConfiguration および Set-NaToolkitConfiguration という 2 つの新しいコマンドレッ

トを使⽤すると、デバッグログの有効化と無効化を簡単に実⾏できます。

新しいコマンドレット Toolkit 2.2 では、新しいコマンドレットが 14 個追加され、コマンドレットの総数は 1,172 個になりました。

Toolkit 2.2 で新たに追加されたホスト側のコマンドレットを次に⽰します。

Add-NaHostIscsiConnection

ConvertTo-NaVhdx

Get-NaHostFcConnectivity

Get-NaToolkitConfiguration

Get-NcHostFcConnectivity

Remove-NaHostIscsiConnection

Set-NaToolkitConfiguration

Toolkit 2.2 で新たに追加された 7-Mode 向けのコマンドレットを次に⽰します。

Add-NaIscsiInterfaceAccess

Get-NaCifsBranchCacheHashStatistics

Remove-NaIscsiInterfaceAccess

Set-NaCifsBranchCacheKey

Toolkit 2.2 で新たに追加された clustered 向けのコマンドレットを次に⽰します。

Get-NcEfficiency

Get-NcTime

Set-NcTime

解決済みの問題 Restore-NaHostFile で、GPT ディスクが読み取り専⽤としてオンラインになったときにエラー

が発⽣することがある。

Restore-NaHostFile で、⼀時的な LUN のディスクボリュームがすぐに検出されないとエラー

が発⽣する。

Get-NaVolAutosize から返される 1,024 の倍数の値が⼤きすぎる。

Set-NaQuota で、既存のクォータの設定を指定しなかった場合にデフォルトの値で上書きされる。


出⼒の型の固定 Toolkit 2.1 は、⼀⾒すると簡易リリースのように思われがちですが、実際にはそうではありません。出⼒

の型を固定するという、アーキテクチャに関する⼤きな変更が⾏われています。

以前のバージョンの Toolkit では、コマンドレットの出⼒の型が変わることがありました。Toolkit 1.6 と

Toolkit 1.7 におけるこの違いを次に⽰します。

以前は、新しいバージョンの API のリリースに合わせてコマンドレットの戻り値の型を更新した⽅が理にかなっていました。この変更は、新しいバージョンへの更新時に下位互換性を維持するための慎重に検討された⽅法であり、平均的な PowerShell ユーザが意識することはあまりありませんでした。しかし、Toolkit を.Net プロジェクトにバンドルする開発者が増えるにつれ、この⽅法はあまり適さなくなりました。これらの型が同じであることが保証されないと、厳密に型指定されたコードの記述が不必要に難しくなるためです（問題が⽣じる危険もあります）。Toolkit 2.1 では、これらの出⼒の型が固定され、リリース間で不変になりました。

この変更により、更新された API が Toolkit に追加されたときに戻り値の型が⾃動的に更新され、Toolkitの各リリースで最新版が確実に使⽤されるようになりました。Toolkit をバンドルしているユーザも、新しいバージョンで既存の戻り値の型が変更されているかどうかを気にせずに、厳密に型指定されたコードを安全に使⽤することができます。

Snapshot からの Windows ファイルのサブ LUN クローニング Data ONTAP 8.1 では、Snapshot から SIS-Clone を実⾏できるようになりました。新しいコマンドレッ

トの Restore-NaHostFile では、この機能を利⽤して、Snapshot の LUN からアクティブファイルシス

テムの LUN にファイルをコピーできます。このコマンドレットを使⽤すると、個々の Windows ファイ

ルを Data ONTAP Snapshot からリストアできます。定期的に Snapshot を作成するようにスケジュール

している場合は、増分バックアップからのファイルのリストアが可能です。このコマンドレットは、Data

ONTAP 8.1 以降を使⽤していれば、7-Mode でも clustered ONTAP でも機能します。

Data ONTAP 8.1 への完全な対応 Toolkit 2.0 で、clustered ONTAP のアーキテクチャが固まり、Data ONTAP 8.1 の API の 84%に対応

するようになりました。Toolkit 2.1 では、これがさらに拡張され、Data ONTAP 8.1 のすべての API に

対応しています。Toolkit 2.1 の clustered ONTAP 向けのコマンドレットは 559 個になり、全部で

1,158 個になりました。

その他の機能強化 Find-NcController では、–All スイッチを指定しないかぎり、クラスタの LIF だけが表⽰されます。これ

により、検出処理での Data ONTAP クラスタの特定が簡単になります。

–All スイッチを指定した場合は、指定したサブネットのすべての SNMP デバイスが返されます。

NDMP コピーのコマンドレットで、増分レベル 0〜9 と、–IncrementalForever スイッチを使⽤した

「永久増分」がサポートされるようになりました。

–IncrementalForever スイッチは、最初のレベル 0 転送の完了後に使⽤できます。

Set-NaUser で、最⼩パスワード⽇数と最⼤パスワード⽇数を設定できるようになりました。

New-NcVserver で、–RepositoryVserver という新しいスイッチを使⽤して、リポジトリ Vserver を

作成できるようになりました（Data ONTAP 8.1.1 の新機能です）。

新しいコマンドレット Data ONTAP PowerShell Toolkit 2.1 で新たに追加されたコマンドレットのうち、clustered ONTAP

向け以外のコマンドレットを次に⽰します。

Restore-NaHostFile

Toolkit 2.1 で新たに追加された clustered ONTAP 向けのコマンドレットのカテゴリを次に⽰します。

ウィルス対策（11 個）

設定のバックアップ（11 個）

ダッシュボード（3 個）

診断（11 個）

FC ポート（1 個）

フラッシュ（2 個）

FlexCache（9 個）

GPO（6 個）

iSCSI（7 個）

Kerberos（5 個）

ネームマッピング（5 個）

NIS（4 個）

ストレージイニシエータ（7 個）

ボリューム（3 個）

Toolkit 2.1 の解決済みの問題 Get-NaSnapvaultSecStatus | Start-NaSnapvaultSecTransfer でパラメータが正しくバ

インドされない。

Invoke-NcClusterHaTakeover で、-Immediate を指定していなくても、すぐに実⾏できない

とエラーが発⽣することがある。

Get-NaSystemLog -AuditLog で、TimeStampDT フィールドを設定できないことがある。

ドキュメントを⼀部修正。


clustered Data ONTAP 8.1 このリリースを「2.0」としたのは、世代が変わったためではなく、Toolkit で clustered ONTAP をサポー

トするアーキテクチャが固まったためです。このリリースでは、clustered ONTAP 向けのコマンドレット

が 86 個追加され、全部で 461 個になりました。これは、clustered Data ONTAP 8.1 の API の 84%に相

当します。

clustered ONTAP での Toolkit の使⽤⽅法について、すでにさまざまな例を⽰してきましたが、ここでは、

clustered ONTAP の複数のコントローラへの同時接続を Toolkit でサポートする⾮常に効果的な⽅法の例

を⽰します。わずか 4 ⾏の PowerShell で、4 つの Vserver を接続し、それぞれの Vserver にボリューム

と LUN を作成して、それぞれの Vserver で認識される igroup に新しい LUN をマッピングできます。特に、

Connect-NcController で–Add スイッチを使⽤している点に注⽬してください。

容量可変 VHD ファイルからシンプロビジョニングされた容量固定 VHD ファイルへの変換容量可変 VHD ファイルで Hyper-V VM を実⾏する利点は、作成時間が短く、ストレージの使⽤量も最⼩

限で済むことです。しかし、容量可変 VHD ファイル形式には、どのようなデータパーティションでフォー

マットしても、SAN の容量可変 VHD ファイルに対するほとんどの I/O がアライメントされないという側

⾯もあります。これは、VM が少なければ⼤きな問題にはなりませんが、コントローラで実⾏する VM が

多くなると、パフォーマンスの⼤幅な低下につながることがあります。

シンプロビジョニングされた容量固定 VHD ファイルを新規に作成するだけであれば、以前のリリースの

Toolkit で導⼊された New-NaVirtualDisk を使⽤して実⾏できます。時間もかからず、事前のストレー

ジ使⽤量も抑えることができます。ただし、Data ONTAP ですでに容量可変 VHD ファイルを使⽤してい

る場合も想定されます。Toolkit 2.0 では、そのような場合にも対応できるように、ConvertTo-NaVhd

が更新され、容量可変 VHD をシンプロビジョニングされた容量固定 VHD に変換できるようになりました。

この変換では、できるだけ短時間で済むように、コピーオフロードとブロックのクローニングが使⽤され

ます。

LUN から VHD ファイルへの変換物理環境から仮想環境に移⾏するには、通常、VM データを LUN から VHD ファイルにコピーするツール

が必要になります。Toolkit 2.0 では、ConvertTo-NaVhd を使⽤して、LUN 全体を別の LUN の VHD

ファイルに変換できます。このコマンドレットでは、LUN のパス、または Data ONTAP LUN に基づくディ

スクのホストディスクインデックスを指定できます。

VHD ファイルから LUN への変換仮想環境から物理環境への移⾏はそれほど⼀般的ではありませんが、負荷が⾼い VM を物理サーバに⼀時

的に移す場合などが想定されます。Toolkit 2.0 では、VHD ファイルから迅速に LUN を作成できるように、

ConvertTo-NaLun が追加されています。

NDMP コピークライアント場合によっては、コントローラ間でデータをコピーしなければならないことがあります。ホストを介して

データをコピーするには、まずソースからホストにデータを移動し、そのあとにホストからデスティネー

ションに移動しなければならないため、時間がかかるうえに、リソースも必要になります。Toolkit 2.0 で

は、PowerShell から NDMP コピーを実⾏できるようになっています。Invoke-NaNdmpCopy を使⽤

して同期的に⾏う⽅法と、Start-NaNdmpCopy、Stop-NaNdmpCopy、および Get-NaNdmpCopy を

使⽤して⾮同期で⾏う⽅法があります。NDMP コピー処理は、完了前に PowerShell セッションを閉じる

と失敗するので注意してください。

実⾏中の NDMP コピー処理は、Get-NaNdmpCopy を使⽤して照会できます。

NDMP コピーのコマンドレットは、7-Mode と clustered ONTAP のどちらのコントローラに対しても使⽤

できます。また、7-Mode のコントローラと clustered ONTAP のコントローラの間でも実⾏できます。

Toolkit 2.0 では、Enable-NaNdmp、Disable-NaNdmp、Enable-NcNdmp、および Disable-

NcNdmp というコマンドレットが追加されています。これらのコマンドレットは、それぞれ、7-Mode

または clustered ONTAP のコントローラで NDMP を有効または無効にする場合に使⽤できます。

CIFS 共有のサポートの強化 Toolkit 2.0 には、引き続き Windows Server 2012 のサポートが組み込まれており、SMB 経由の

Hyper-V がサポートされます。New-NaVirtualDisk を使⽤して、シンプロビジョニングされた VHD ファ

イルを CIFS 共有で迅速に作成できるようになりました。また、Remove-NaHostFile で、CIFS 共有の

ファイルをシームレスに削除できるようになりました。

インストールスクリプト PowerShell モジュールのインストールの優れた点は、登録の必要がないことです。候補となるいくつか

の場所のうちのいずれかにファイルをコピーするだけでインストールを実⾏することができます。ただし、

問題がまったくないわけではありません。特に注意が必要なのは、DataONTAP.zip ファイルをインター

ネットからダウンロードしたあとにゾーン ID のセキュリティフラグをクリアしないと、Toolkit のロード

が失敗することです。この問題に対処するために、Toolkit に付属の Install.ps1 スクリプトと

Uninstall.ps1 スクリプトの処理が⾒直され、Toolkit のロードが常に正しく⾏われるように、インストー

ラのスクリプトでゾーン ID がクリアされるようになりました。ほとんどの場合、すべての設定をデフォ

ルトのままにして実⾏すれば、Toolkit を数秒でインストールできます。実⾏する必要があるのは、これら

のスクリプトを DataONTAP.zip ファイルと同じディレクトリに格納することだけです。システムレベル

の PowerShell ディレクトリにアクセスする場合は、管理者権限が必要になることがあります。

アンインストールも同様に簡単です。インストールされているバージョンがスクリプトで⽰されることに

注⽬してください。

その他の機能強化 clustered ONTAP の Vserver 向けに、iSCSI イニシエータのターゲットポータルの設定を処理する

Add-NcHostIscsiTargetPortal という新しいコマンドレットが追加されました。

Invoke-NaSsh および Invoke-NcSsh でタイムアウトパラメータを指定できるようになりました。こ

れにより、複数のシステムにコマンドを送信するスクリプトで、いずれかのシステムに到達できない場合

の処理が⾼速になります。

Get-NaEfficiency に、ボリュームまたはアグリゲートのオーバープロビジョニングの度合いを⽰すフィー

ルドが追加されました。コマンドレットでこの値を計算するには、–Recurse スイッチを使⽤します。

RPC のエラーメッセージは⼀般的すぎて、詳しい内容がわからないことがあります。Toolkit 2.0 では、

Windows の RPC サブシステムから返されたエラーに関する詳しい説明が返されます。

Data ONTAP 8.1 では、デフォルトでは 64 ビットアグリゲートが作成されます。New-NaAggr に追加

された–Use32Bit スイッチを使⽤すると、強制的に 32 ビットアグリゲートを作成できます。

Data ONTAP 8 の⼀部のバージョンでは、バグが原因で、種類を指定せずに igroup を作成した場合にコン

トローラがパニック状態になることがあります。これを回避するために、New-NaIgroup および

New-NcIgroup で、種類の値が設定されていない場合は「windows」の igroup がデフォルトで作成さ

れるようになりました。

Get-NaClone を基盤となる API の動作に近づけるために、いくつかのパラメータが追加されています。



Invoke-NaEmsAutosupportLog

Rename-NaFile

Get-NaLunAttribute

Set-NaLunAttribute

ConvertTo-NaLun

Disable-NaNdmp

Enable-NaNdmp

Invoke-NaNdmpCopy

Start-NaNdmpCopy

Stop-NaNdmpCopy

Get-NaNdmpCopy

新たに追加された clustered ONTAP 向けのコマンドレットのカテゴリを次に⽰します。

監査（2 個）

AutoSupport（11 個）

CF（6 個）

クロック（1 個）

EMS（19 個）

ホスト（1 個）

ネームマッピング（10 個）

NDMP（2 個）

パフォーマンス（4 個）

QoS（18 個）

SES（3 個）

システム（7 個）

WAFL（2 個）

Toolkit 2.0 の解決済みの問題 Get-NaHostDisk の出⼒に、⼀部のフィールドが表⽰されないことがある。

⼀部のクローニング処理（Repair-NaVirtualDiskAlignment、Copy-NaHostFile）が、Data

ONTAP API での演算のオーバーフローが原因で失敗することがある。

Get-NaVol で EONTAPI_ENOMEM が返されることがある。


V2V ユーティリティ VHD と VMDK の間でディスクイメージの形式を変換するツールは、すでにさまざまなものが提供されて

います。しかし、データブロックを Windows ホストを介してコピーするよりも、ストレージコントロー

ラ上でインプレースでクローニングした⽅が、パフォーマンスははるかに⾼くなります。Toolkit 1.7 では、

ConvertTo-NaVhd および ConvertTo-NaVmdk という 2 つのコマンドレットが追加されています。

これらのコマンドレットを使⽤すると、それらの形式をわずか数秒で変換することができます。同じ

Windows 2008 R2 サーバで同じ VMDK ファイルを使⽤して、同⼀の条件下で測定した結果を次に⽰し

ます。

⼀般的な市販のツールを使⽤して 32GB のフラットな VMDK ファイルを容

量固定 VHD に変換

46 分

ConvertTo-NaVhd を使⽤して 32GB のフラットな VMDK ファイルを容量

固定 VHD に変換

63 秒

ブート可能な VMDK ファイルからブート可能な VHD ファイルが⽣成されるとは限らないことに注意して

ください（逆についても同様です）。適切なストレージドライバがイメージに含まれ、ブート前に正しく

設定されるようにするために、OS やハイパーバイザーに固有の変更作業が必要になることがあります。

オペレーティングシステムによっては、ファイル形式の変換後の最初のブート時に修復作業を⾏うなどの

⽅法で、⾃動的にリカバリできるものもあります。

VHD ファイルのアライメント仮想環境でのディスクパフォーマンスの低下を引き起こす最も⼀般的な原因の 1 つに、適切にアライメン

トされない I/O があります。Toolkit 1.7 では、VHD ファイルのアライメントの問題を検出して修正する

2 つのコマンドレットが追加されています。

Get-NaVirtualDiskAlignment を使⽤すると、容量固定 VHD ファイルの最初のセクターを読み取り、

VHD に適切にアライメントされていないパーティションがないかどうかを確認できます。GPT ディスク

でアライメントの問題が発⽣することはめったにないため、このコマンドレットでは、MBR 型のディスク

ファイルのみがサポートされます。パーティションのタイプは重要ではなく、拡張ブートレコードもサ

ポートされます。

Repair-NaVirtualDiskAlignment を使⽤すると、MBR 型のディスクとしてフォーマットされた容量

固定 VHD ファイルのアライメントの問題を修正できます。Toolkit の他の⼀部のコマンドレット（Copy-

NaHostFile や ConvertTo-NaVhd など）とは異なり、アライメントの問題の修正には、WAFL ブロッ

クのクローニングは使⽤できません（クローニングされたブロックのアライメントも正しくないためです）。

したがって、データコピーが必要になります。LUN のデータの場合、Data ONTAP 7.3.5 以降の 7.3.x の

バージョンでは、コピー処理をストレージコントローラにオフロードすることでこの処理を迅速に実⾏で

きます。Data ONTAP 8 ではこの機能をまだ利⽤できないため、必要に応じて、時間がかかるホストベー

スのコピーが使⽤されます。CIFS 共有の場合は、Data ONTAP 7.3.5 以降および 8.0.1 以降のすべての

バージョンで、コピーオフロードが使⽤されます。

clustered Data ONTAP 8.1 Toolkit 1.7 では、clustered ONTAP 向けの API を実装するコマンドレットが新たに 227 個追加され、

ユーザは clustered ONTAP の管理に 375 個のコマンドレットを使⽤できるようになりました。

clustered Data ONTAP と Data ONTAP 7-Mode には、多くの類似点がある⼀⽅で、PowerShell ユーザ

に影響する⼤きな相違点もいくつかあります。何より重要な違いは、clustered ONTAP には、7-Mode の

物理コントローラに対応する「vfiler0」に相当するものがないことです。clustered ONTAP は、クラスタ

の物理リソース（ディスク、ノード、アグリゲート、ネットワークポートなど）の管理に使⽤する 1 つの

「管理」Vserver と、データの提供とそれに関連する仮想コンポーネント（ボリューム、qtree、LUN、プ

ロトコル、Snapshot など）の管理に使⽤する 1 つ以上のデータ Vserver で構成されます。

API（およびコマンドレット）には、クラスタ管理 Vserver でのみ処理されるものと、データ Vserver で

のみ処理されるものがあることに注意してください。Toolkit ユーザは、コマンドレットをそれぞれ適切な

Vserver に送信する必要があります。コマンドレットの送信はさまざまな⽅法で実⾏することができ、場

合によっては⾃動的に実⾏されることもあります。

たとえば、クラスタ管理 Vserver に接続するには、次のコマンドを実⾏します。

クラスタ管理 Vserver に接続した状態でデータ Vserver にコマンドレットを送信する⽅法は複数あります。

1. クラスタ Vserver への接続時にデータ Vserver を設定します。以降のすべてのコマンドレットが、

指定した Vserver に送信されるようになります。

2. クラスタ Vserver に接続したあとに、任意の時点でデータ Vserver を設定します。

3. コマンドレットの引数として、送信先のデータ Vserver を指定します。

4. クラスタ Vserver またはデータ Vserver で Get コマンドを使⽤し、その出⼒を他のコマンドレットにパイプします。Toolkit には、パイプラインに書き込まれたオブジェクトに関する⼗分なコンテキストがあり、それに基づいて以降のコマンドレットの送信先が決定されます。

また、データ Vserver の管理インターフェイスに直接接続することもできます。データ Vserver に直接接続した場合は、クラスタ管理 Vserver や他のデータ Vserver にコマンドレットを発⾏できません。

Get コマンドレットの多くは、クラスタ管理 Vserver とデータ Vserver のどちらのコンテキストでも動作します。コマンドレットの送信先を判断するには、Get-NcHelp を使⽤して、Family フィールドを確認してください。

CIFS のファイルクローニング

Copy-NaHostFile で、CIFS 共有のファイルが透過的にサポートされるようになりました。これにより、ファイルを LUN と Data ONTAP の共有のどちらにクローニングする場合も、ファイルの格納場所がコマンドレットで特定され、それぞれに適した⼿順で迅速にファイルがクローニングされます。コントローラのクレデンシャルを明⽰的に指定していない場合は、Toolkit のキャッシュから取得されます。ただし、clustered ONTAP の CIFS の場合は、共有情報から Vserver の管理 LIF の情報をコマンドレットで判別することはできないため、有効な–Controller パラメータ（または現在の接続コンテキスト）を指定する必要があります。

クラスタ共有ボリュームのスペース再⽣ Invoke-NaHostVolumeSpaceReclaim で、クラスタ化された Hyper-V 環境の CSV がサポートされ

るようになりました。このコマンドレットによる CSV の処理では、特定の NTFS API がサポートされな

いため、別のアルゴリズムが使⽤されます。再⽣処理が開始されると、CSV の使⽤量が短時間で 98%まで

達しますが、CSV に対するほとんどの I/O は VHD ファイル（ネットアップのベストプラクティスに従うと

容量固定 VHD）に格納されるため⼼配はいりません。また、Windows 側では⼀時的にスペースが使⽤さ

れますが、関連する WAFL ブロックはプロセス中も継続して解放されるため、このコマンドレットはシン

プロビジョニング環境でも機能します。

その他の機能強化 LUN オブジェクトのアライメント情報が追加されました（Data ONTAP 8.0.1 以降が必要です）。

SIS のオブジェクトおよびコマンドレットでボリュームの圧縮がサポートされるようになりました（Data

ONTAP 8.0.1 以降が必要です）。

セキュリティを強化するために、コントローラのパスワードが SecureString 値として保持されるように

なりました。

Get-NaHostDisk でレポートされるターゲット側のフィールドがいくつか追加されました。

Wait-NaHostDisk で、シリアル番号を指定してディスクの追加を検出できるようになりました。

CIFS 共有のコマンドレットに、アクセスベースの列挙とネームスペースのキャッシュの両⽅に対応するパ

ラメータが追加されました。

New-NaSnapshotMulti に、新たに作成した Snapshot を出⼒するオプションが追加されました。

新しいコマンドレットの Get-NaControllerError を使⽤すると、Data ONTAP のすべてのエラーコー

ドと説明を表⽰できます。これらのコードは、7-Mode と clustered ONTAP で共通です。

以前のリリースでは、特定の状況下で、システムメモリが余分に使⽤されることがありました。Toolkit

1.7 では、メモリの処理が改善され、コマンドレットを繰り返し呼び出す場合のパフォーマンスが⼤幅に

向上しています。

Set-NaVirtualDiskSize の縮⼩処理で、不明なタイプのパーティションが上書きされなくなりました。ま

た、拡張や縮⼩の処理で既知のタイプのパーティションが変更されないように指定する-Preserve スイッ

チが追加されました。

Toolkit 1.7 では、コントローラ接続を永続的に保存できるようになりました。NaController と

NcController（Connect-NaController および Connect-NcController で⽣成）のどちらについても、

ConvertTo-SerializedString および ConvertFrom-SerializedString という 2 つの新しいコマンド

レットを使⽤してシリアル化することができます。これにより、Toolkit の接続コンテキストを保存して、

同じホストの他のプロセスで使⽤できるようになりました。これらの新しいコマンドレットは、インター

フェイスを実装する.NET オブジェクトに対応しています。



ConvertTo-NaVhd

ConvertTo-NaVmdk

Get-NaVirtualDiskAlignment

Repair-NaVirtualDiskAlignment

Enable-NaStorageAdapter

Get-NaStorageAdapter

Get-NaStorageAdapterInfo

Get-NaControllerError

ConvertTo-SerializedString

ConvertFrom-SerializedString

新たに追加された clustered ONTAP 向けのコマンドレットのカテゴリを次に⽰します。

CIFS（32 個）

クローン（1 個）

クラスタピア（6 個）

ディスク（10 個）

エクスポート（9 個）

FC（4 個）

FCP（20 個）

ファイル（9 個）

igroup（10 個）

iSCSI（30 個）

NET（27 個）

NFS（13 個）

ポートセット（5 個）

クォータ（9 個）

セキュリティ（13 個）

SIS（10 個）

SnapMirror（16 個）

ストレージアダプタ（3 個）

Toolkit 1.7 の解決済みの問題 7-Mode 向けのコマンドレットで、ワイルドカードパターンの null 処理が修正されました。

Get-NaVol のエラー処理が修正されました。

Invoke-NaHostVolumeSpaceReclaim で、4TB を超える LUN がサポートされるようになりま

した。


VHD ファイルのユーティリティ Virtual Hard Disk（VHD;仮想ハードディスク）ファイルは、Microsoft Hyper-V や Citrix XenServer な

ど、複数のハイパーバイザーの中⼼となるファイルです。それらに共通する課題として、容量固定 VHD ファ

イルを作成する際に、ファイルが完全に初期化されるため、作成に時間がかかるという問題があります。

また、初期化されることで、基盤となるストレージメディアの全サイズが VHD に使⽤されることになり

ます。代わりに容量可変 VHD ファイルを使⽤する⽅法もありますが、容量可変 VHD に対する I/O は適切

にアライメントされないため、必ずしも適切な⽅法とはいえません。

新しいコマンドレットの New-NaVirtualDisk を使⽤すると、任意のサイズの VHD ファイルが瞬時に作

成され、Data ONTAP の関連するブロックが迅速に解放されるため、最初にスペースを確保する必要があ

りません。VHD ファイルは Data ONTAP LUN のディスクに格納する必要がありますが、コントローラの

クレデンシャルは必要ありません。時間をどれくらい短縮できるかを⽰す簡単な例を次に⽰します。

Windows Server 2008 R2 の Hyper-V マネージャを使⽤して 500GB の

容量固定 VHD を作成

1 時間 41 分

New-NaVirtualDisk を使⽤して 500GB の容量固定 VHD を作成 21 秒

このコマンドレットは、新しい VHD ファイルの完全修飾パスとサイズを指定するだけで実⾏できます。

Set-NaVirtualDiskSize というもう 1 つのコマンドレットでは、容量固定 VHD ファイルの拡張や縮⼩を

迅速に⾏うことができます。ファイルに追加されたスペースやファイルから削除されたスペースは、スト

レージコントローラで再⽣されます。VHD ファイル内に NTFS データのパーティションがある場合は、

NTFS API を使⽤して、ファイルの末尾に最も近いパーティションが⾃動的に拡張または縮⼩されます。

この処理では、内部のパーティションの確認と調整のために、VHD が⼀時的にローカルホストにマウン

トされるため、仮想マシンを実⾏している場合など、VHD ファイルを使⽤中のときは、この処理を実⾏す

ることはできません。VHD ファイルでパーティションを設定した場合、パーティションの内容は NTFS で

管理されるため、特定の範囲までしかファイルを縮⼩できなくなることに注意してください。

Mount-NaVirtualDisk を使⽤すると、任意の VHD ファイルをローカルホストにディスクとしてマウン

トできます。また、Dismount-NaVirtualDisk を使⽤すると、VHD ベースのディスクがディスマウント

され、仮想マシンの設定など、他の⽬的に使⽤できるようになります。これらのコマンドレットは、ディ

スクおよびボリュームの管理⽤の Toolkit 1.6 の新しいコマンドレットと組み合わせて使⽤すると便利です。

スペース再⽣ Data ONTAP LUN でホストされている NTFS 形式のボリュームからファイルを削除しても、ストレージ

コントローラの関連するブロックは⾃動的に解放されず、NTFS によって同じ場所に新しいデータが書き

込まれるまでは割り当てられた状態のままになります。これにより、シンプロビジョニング LUN によるス

ペース削減の効果が徐々に⼩さくなることがあります。Toolkit 1.6 では、2 つのコマンドレットを使⽤し

てこの問題を軽減できます。

Remove-NaHostFile を使⽤すると、ファイルを削除する前に、関連する WAFL ブロックを LUN から解

放できます。このコマンドレットは、セキュリティ対策としても効果があります。削除したファイルの内

容をリカバリできるディスクユーティリティはありますが、ブロックの場合は、⼀度解放してしまえば、

初期化されたブロックしか読み取られません。そのため、削除したファイルに格納されていたデータが取

得されることはありません。このコマンドレットでは、ローカルファイルシステムに対する Toolkit の多

くのコマンドレットと同様に、ファイルの完全修飾パスを指定する必要があります。

Invoke-NaHostVolumeSpaceReclaim を使⽤すると、NTFS ボリューム全体をスキャンして、既存の

ファイルに関連付けられていない WAFL ブロックをすべて解放できます。このコマンドレットは、通常の

I/O 処理の実⾏中でも実⾏できます。通常、このコマンドレットは、ONTAP でホストされるすべてのディ

スクを対象に、週 1 回などの間隔で、処理が少ない時間帯に実⾏することを推奨します。スクリプトのス

ケジュールをこのように設定すれば、LUN のスペース効率を最⼤限に保つことができます。現在のところ、

Invoke-NaHostVolumeSpaceReclaim は Cluster-Shared Volume（CSV;クラスタ共有ボリューム）

には対応していません。

スペース再⽣コマンドのパフォーマンスはさまざまな要因によって異なりますが、1 つの例として、この

コマンドレットで 1TB の LUN を再⽣した結果を次に⽰します。

Data ONTAP でホストされている、ローカルホストにマウントされたすべての LUN のすべての未使⽤ス

ペースを再⽣するには、次のコマンドを使⽤します。

Windows のディスクとボリュームの管理 Toolkit の以前のリリースでは、Data ONTAP への iSCSI 接続を開始し、新しい LUN と igroup を作成し

て、LUN を Windows ホストにマッピングするところまで実⾏できました。しかし、それだけでは不⼗分

で、新しいディスクをスキャンして初期化し、フォーマットされたボリュームを作成する処理は、

Windows 側で実⾏しなければなりませんでした。Toolkit 1.6 では、それらの処理も実⾏できるように、

ホスト側のディスクおよびボリュームを操作するコマンドレットが追加されています。

Start-NaHostDiskRescan

Initialize-NaHostDisk

Set-NaHostDisk

Wait-NaHostDisk

Get-NaHostVolume

New-NaHostVolume

Format-NaHostVolume

Mount-NaHostVolume

Dismount-NaHostVolume

Set-NaHostVolumeSize

Remove-NaHostVolume

⼀部のコマンドレット（New-NaHostVolume、Format-NaHostVolume、Remove-

NaHostVolume）では、オプションで Data ONTAP のスペース再⽣も利⽤できます。

New-NaHostVolume を使⽤すると、新しいディスクをすばやく初期化することができます。NTFS の新しいパーティションが⾃動的に作成されて、そのディスク内でマウントされます。新たに検出されたすべてのディスクをフォーマットしてマウントする例を次に⽰します。

それぞれの⼿順をより細かく制御する必要がある場合は、Initialize-NaHostDisk、New-NaHostVolume、Format-NaHostVolume、および Mount-NaHostVolume を個別に使⽤します。

VHD とボリュームの新しいコマンドレットを組み合わせて使⽤すると、新しい VHD ファイルの作成とフォーマットを同時に⾏うことができます。New-NaHostVolume では、常に、1MB の境界にアライメントされたパーティションが作成されます。そのため、新しいパーティションに配置するオペレーティングシステムやデータセットに関係なく、適切にアライメントされない I/O の影響を受けない VHD ファイルを簡単に作成できます（適切な OS タイプの LUN に配置した場合）。

Toolkit 1.5 のプロビジョニングのコマンドレットをベースに、ストレージのプロビジョニングの作業を、フォーマットしてローカルホストにマウントするところまで実⾏できるようになりました。新しいコマンドレットを⾚で⽰しています。

ファイルクローニング Copy-NaHostFile を使⽤すると、NTFS 形式の 1 つの Data ONTAP LUN 内（または複数の LUN の間）

で個々のファイルをクローニングできます。LUN はローカルホストにマウントされていて、同じ Data

ONTAP ボリュームに格納されている必要があります。このコマンドレットでは、Data ONTAP の SIS-

Clone 機能を使⽤してファイルが迅速にクローニングされます。Windows ホストを介してデータをコピー

するのではなく、Data ONTAP でブロックを共有することで、スペース効率の⾼いクローンが作成されま

す。このコマンドレットはさまざまな⽤途に応⽤可能で、たとえば、仮想マシン内の sysprep で構成した

VHD ファイルを複製するクローニングワークフローもサポートできます。

SSH のセットアップ多くの要望に応え、Data ONTAP で SSH サーバの設定を⾏えるようになりました。これを⾏うための

API は提供されておらず、因果関係は不明ですが、この処理が完了してからでないと「Invoke-NaSsh

secureadmin setup」は機能しません。新しいコマンドレットの Initialize-NaSecureAdminSsh を使

⽤すると、「secureadmin setup」に相当する処理を実⾏することができます。

vFiler の移⾏「vFiler」カテゴリの 4 つの新しいコマンドレットで、Data ONTAP の vFiler 移⾏機能がサポートされ

ます。

対応する API の増加 Toolkit 1.6 で、複数のカテゴリに分類される 31 個のコマンドレットが追加され、予定していた Data

ONTAP 7-Mode 向けのすべての API が揃いました。新しいコマンドレットの多くでは、Data ONTAP

8.0 以降が必要です。

clustered Data ONTAP 8.1 Toolkit 1.6 では、clustered Data ONTAP 8.1 RC1 のリリースに伴い、clustered ONTAP の管理⽤のコ

マンドレットが先⾏して導⼊されています。clustered ONTAP が今後の Data ONTAP の中⼼となること

に議論の余地はありませんが、7-Mode とは⼤きく異なるものであるため、PowerShell Toolkit の 7-Mode

向けの既存のコマンドレットに clustered ONTAP のサポートを移⾏するのは実⽤的ではありません。複数

のコントローラ接続、Vserver のシームレスな処理、clustered ONTAP の⾼度なクエリなどがサポートさ

れたのを機に、clustered ONTAP 向けのコマンドレットのアーキテクチャを強化しています。次にいくつ

かの例を⽰します。-Nc というプレフィックスは、clustered ONTAP 向けのコマンドレットであることを

⽰しています。

クラスタ LIF に接続する例を次に⽰します。

ノードを⼀覧表⽰する例を次に⽰します。

ワイルドカードを使⽤して、複数の Vserver のボリュームを⼀覧表⽰する例を次に⽰します。この例では、

ワイルドカードに注⽬してください。clustered ONTAP 向けのほぼすべてのコマンドレットと同様に、

Windows ホストに送信されてフィルタリングされる情報の量を制限するために、処理を Data ONTAP に

オフロードしています。

clustered ONTAP の⾼度なクエリを使⽤して、1TB を超えるアグリゲートを検索する例を次に⽰します。

データフィルタリングを Data ONTAP にオフロードして、ホストに関連するオブジェクトだけを送信してい

ます。

単⼀の Vserver の⼀連のボリュームから週単位の Snapshot を削除する例を次に⽰します。この例では、

接続しているクラスタ LIF で snapshot-delete API がサポートされていなくても、Snapshot を削除でき

ることに注⽬してください。

-Add スイッチを使⽤して 2 つの異なるクラスタに同時に接続し、それらのノードの情報を表⽰する例を

次に⽰します。

その他の機能強化データサイズの⼊⼒がより標準化され、バイト数または⽂字列形式の値に単位を付けて指定できるように

なりました。データサイズの値を変更するコマンドレットで、サイズの絶対値、サイズの正または負の増

分値、正または負の割合の値のいずれも指定できます。次に例を⽰します。

LUN を 20GB 拡張する例を次に⽰します。

LUN を 20%拡張する例を次に⽰します。

Get-NaSystemLog が次のように強化されています。

SnapMirror ログのサポートの追加

-StartTime パラメータを指定した場合のパフォーマンスの向上

ログローテーションによる-Follow スイッチの動作の修正

-EventType パラメータと-Severity パラメータで配列を指定可能になったことによるフィルタリン

グの向上

Add-NaHostIscsiTargetPortal および Connect-NaHostIscsiTarget に-RadiusGenerate スイッチ

と-RadiusVerify スイッチが追加されました。

Set-NaVfilerAddress で、ユーザが IpbindingInfo オブジェクトを作成しなくても IP アドレスを設定で

きるようになりました。

Get-NaLunMap で LUN のパスが出⼒されるようになり、パイプラインのサポートが強化されました。

Toolkit 1.6 では、接続のタイムアウトがより明確に報告されます。



Disable-NaCopyOffload

Enable-NaCopyOffload

Test-NaCopyOffload

Ping-NaFcp

Ping-NaFcpInfo

Test-NaFpolicy

Copy-NaHostFile

Dismount-NaHostVolume

Dismount-NaVirtualDisk

Format-NaHostVolume

Get-NaHostVolume

Initialize-NaHostDisk

Invoke-NaHostVolumeSpaceReclaim

Mount-NaHostVolume

Mount-NaVirtualDisk

New-NaHostVolume

New-NaVirtualDisk

Remove-NaHostFile

Remove-NaHostVolume

Set-NaHostDisk

Set-NaHostVolumeSize

Set-NaVirtualDiskSize

Start-NaHostDiskRescan

Wait-NaHostDisk

Get-NaLunClone

Get-NaLunTargetDeviceId

ConvertTo-NaUnixUser

ConvertTo-NaWindowsUser

Get-NaUnixGroup

Get-NaNetDcb

Get-NaNetDcbPriority

Add-NaRadiusServer

Disable-NaRadius

Enable-NaRadius

Get-NaRadiusServer

Get-NaRadiusStatistics

Remove-NaRadiusServer

Reset-NaRadiusStatistics

Test-NaRadius

Initialize-NaSecureAdminSsh

Get-NaSnapmirrorConnection

Remove-NaSnapmirrorConnection

Set-NaSnapmirrorConnection

Get-NaSnapshotRestoreStatus

Complete-NaVfilerMigrate

Get-NaVfilerMigrate

Start-NaVfilerMigrate

Stop-NaVfilerMigrate

Invoke-NaWaflSync

Toolkit 1.6 の解決済みの問題 vFiler が所有する LUN の Invoke-NaSysstat で監視が可能になりました。

Add-NaNetVlan が 8.0.2 で機能するようになりました。-Gvrp スイッチを使⽤して、作成した

VLAN インターフェイスで GVRP を有効にできます。

Initialize-NaController で Data ONTAP 8 7-Mode がサポートされるようになりました。


Storage Efficiency 試算ツール Data ONTAP の卓越した価値提案における中⼼的な機能の 1 つに、重複排除、シンプロビジョニング、

Snapshot、クローニング、圧縮などのテクノロジを使⽤した Storage Efficiency があります。新しいコ

マンドレットの Get-NaEfficiency を使⽤すると、ネットアップ標準の Storage Efficiency 試算ツールを

組み込むことができます。これは、シンプロビジョニング環境の監視およびレポートのスクリプトで特に

役⽴ちます。

Data ONTAP PowerShell のコミュニティに掲載されているスクリプトを参照してください。このスクリ

プトを使⽤すると、Get-NaEfficiency のデータを Microsoft Excel にインポートし、表形式やグラフで

表⽰できます。

ホスト側の iSCSI および FC のユーティリティ

「ホスト」カテゴリのいくつかの新しいコマンドレットで、Windows 側での iSCSI のインターフェイスおよび接続の設定がサポートされます。

Add-NaHostIscsiTargetPortal Connect-NaHostIscsiTarget Disconnect-NaHostIscsiTarget Get-NaHostIscsiAdapter Get-NaHostIscsiSession Get-NaHostIscsiTarget

次のコマンドレットを使⽤すると、ホスト側の iSCSI のインターフェイス、セッション、およびターゲットを列挙できます。Windows ホストの IQN を簡単に取得できるため、それだけでも便利です。

Get-NaHostIscsiSession には、ローカルディスクやリモートターゲットに関する情報が含まれます。

これらの Get コマンドレットでは、いずれにも WMI パスのフィールドがあるため、PowerShell WMI ア

クセラレータを使⽤して関連オブジェクトの WMI クエリを実⾏できます。

新しいコマンドレットでは、Data ONTAP ストレージコントローラへの iSCSI 接続の設定と解放もサポー

トされます。この⽅法を⽰す簡単なスクリプトを次に⽰します。このスクリプトでは、コントローラで新

しいアグリゲート、ボリューム、および LUN を設定し、現在の Windows ホストからコントローラへの新

しい iSCSI 接続を確⽴します。そのあと、ホストのイニシエータを含む新しいイニシエータグループを設

定し、新しい LUN をホストにマッピングします。新しいコマンドレットを⾚で⽰しています。

複数のパスを指定した接続もサポートされます。

Toolkit 1.5 では、さらに、ファイバチャネルインターフェイスを⼀覧表⽰する Get-NaHostFcAdapter

というコマンドレットも追加されています。このコマンドレットを使⽤すれば、ベンダー固有のツールを

使⽤しなくてもこの情報を取得できます。

ONTAP のログの解析と監視多くの要望に応え、Toolkit 1.5 では、Data ONTAP の 3 種類のログ（メッセージ、監査ログ、および

EMC ログ）の内容を解析および表⽰できるように、Get-NaSystemLog というコマンドレットが追加され

ました。

Get-NaSystemLog では、イベントの重要度、イベントのソース、⽇付範囲など、いくつかの条件によ

るフィルタリングが可能です。過去 1 週間のエラーを⼀覧表⽰する例を次に⽰します。

Get-NaSystemLog では、UNIX の「tail -f」コマンドのように、変更のログを監視することもできます。

Data ONTAP によってメッセージログファイルに書き込まれたエラーメッセージを検出して表⽰する例を


ディスクシグネチャの操作 Windows クラスタのクローン LUN は、ディスクシグネチャが親と⼀致するためにオフラインのままにな

ることがあります。そのため、クローンをクラスタホストにマッピングする前に、クローンのディスク

シグネチャを更新することが重要です。

新しいコマンドレットの Get-NaLunSignature を使⽤すると、MBR ディスクと GPT ディスクの両⽅の

シグネチャを表⽰できます。

また、Set-NaLunSignature というもう 1 つの新しいコマンドレットでは、正しい種類の新しいディス

クシグネチャを⽣成して書き込むことができます。

どちらのコマンドレットも、Windows 固有のコマンドレットではなく、他のオペレーティングシステム

の MBR ディスクまたは GPT ディスクとしてフォーマットされた LUN にも使⽤できます。

ホストディスクおよび VM の検出時間の短縮このリリースでは、特に Windows クラスタにおいて、Get-NaHostDisk および Get-NaHyperV のパ

フォーマンスが⼤幅に向上しています。

Toolkit 1.4 を使⽤した場合、1,000 個の仮想マシンを含む Hyper-V クラスタの列挙に 35 分かかります。

Toolkit 1.5 では、同じタスクを 25 秒で完了できます。

vFiler DR 「vFiler」カテゴリの 5 つの新しいコマンドレットで、Data ONTAP の vFiler ディザスタリカバリ（DR）

機能がサポートされます。

SnapLock Toolkit 1.5 では、Data ONTAP の SnapLock をサポートするコマンドレットが 11 個追加されています。

セキュアなパスワード処理クリアテキストのパスワードを指定するいくつかのコマンドレットで、PSCredential オブジェクトも指定

できるようになりました。次に主なものを⽰します。

Add-NaIscsiInitiatorAuth

Get-NaCifsOrganizationalUnit

Get-NaCifsSite

New-NaCifsPasswordFile

New-NaUser

Set-NaCifs

Set-NaIscsiInitiatorAuthChap

Set-NaIscsiInitiatorDefaultAuth

Set-NaUserPassword

Set-NaVfilerPassword

Test-NaCifsName

その他の機能強化 PowerShell のベストプラクティスに従い、-WhatIf スイッチを指定した場合は、Toolkit のコマンドレッ

トでオブジェクトが⽣成されなくなりました。同様に、⼊⼒レコードの処理中にエラーが発⽣した場合も

オブジェクトは⽣成されません。

Remove-NaVol に-Force スイッチが追加されました。このスイッチは、デフォルト以外の vFiler にボリ

ュームのストレージがある場合に指定する必要があります。

Invoke-NaSysstat の WAFL 出⼒情報に Consistency Point（CP;整合ポイント）の詳細が表⽰されるよ

うになりました。報告される CP の種類は Data ONTAP のバージョンによって異なるため、Invoke-

NaSysstat の出⼒では、CP の種類を⽰すラベルも報告されます。

コマンドレットのタイムアウトについて⼀部の Toolkit ユーザから報告された問題に対処するために、

Toolkit のコマンドレットのデフォルトのタイムアウトが 60 秒に引き上げられました。タイムアウトを調

整する場合は、これまでと同様に、Connect-NaController から返される NaController オブジェクトの

関連するフィールドを変更します。

新しいコマンドレット Data ONTAP PowerShell Toolkit 1.5 で新たに追加されたコマンドレットを次に⽰します。

Add-NaHostIscsiTargetPortal

Connect-NaHostIscsiTarget

Disconnect-NaHostIscsiTarget

Get-NaHostIscsiAdapter

Get-NaHostIscsiSession

Get-NaHostIscsiTarget

Get-NaHostFcAdapter

Get-NaLunSignature

Set-NaLunSignature

Get-NaSnaplockComplianceClock

Get-NaSnaplockLog

Get-NaSnaplockLogVolume

Get-NaSnaplockOption

Get-NaSnaplockRetentionTime

New-NaSnaplockLog

Remove-NaSnaplockFile

Set-NaSnaplockComplianceClock

Set-NaSnaplockLogVolume

Set-NaSnaplockOption

Set-NaSnaplockRetentionTime

Get-NaSystemLog

Get-NaEfficiency

Get-NaVfilerDr

Invoke-NaVfilerDr

Invoke-NaVfilerDrResync

New-NaVfilerDr

Remove-NaVfilerDr

Toolkit 1.5 の解決済みの問題 Set-NaSis、Start-NaSis、および Stop-NaSis で、パスパラメータがプロパティ名に基づいてバ

インドされるようになりました。

Set-NaVfilerPassword で、root ユーザが存在しない場合に作成されるようになりました。

オフラインのホストディスク（LUN）がある場合に Get-NaHostDisk および Get-NaHyperV が失

敗する問題が解決されました。


sysstat 多くの要望に応え、Toolkit で Data ONTAP の sysstat CLI コマンドを呼び出せるようになりました。

Toolkit 1.4 で追加されたこの Invoke-NaSysstat コマンドレットでは、パフォーマンス API を使⽤し

て、常に最新のメトリクスが返されます。

デフォルトでは、15 秒間隔でデータが収集され、その出⼒がオブジェクト形式で PowerShell パイプラ

インに書き込まれます。Toolkit のデータフォーマッタでは、パフォーマンスデータが表形式で出⼒され

ます。

書式設定されていない出⼒では、データサイズはバイト数、データ速度は 1 秒あたりのバイト数、レイ

テンシは TimeSpan オブジェクトとして⽰されます。表形式の表⽰では、データのサイズと速度は単位付

きで⽰され、レイテンシはミリ秒で⽰されます。

Invoke-NaSysstat では、ボリューム、ディスク、ネットワークアダプタなどのその他のオブジェクト

のほか、各種のプロトコルも監視できます。さらに、同じ種類の複数のオブジェクトをまとめて監視する

こともできます。2 つのボリュームを監視する例を次に⽰します。

Invoke-NaSysstat では、ワイルドカードも指定できます。ループ上のすべてのドライブを監視する例を


Invoke-NaSysstat は、表形式での継続的な監視だけでなく、ハッシュテーブルの出⼒を介してスクリ

プトでも使⽤できるように最適化されています。パイプラインを継続的に監視してもそれほど効果的でな

いスクリプトでは、-Hashtable を指定し、-Count の値を 1 に指定します。そのあと、オブジェクト名を

指定してハッシュテーブルにインデックスを設定します。

システムレベルのその他のパフォーマンスデータをすべて⼀度に収集するには、-AllProtocols スイッチを

使⽤します。

Invoke-NaSysstat では、指定した期間のデータの合計または平均が求められます。この期間を変更す

るには、-SampleIntervalSeconds パラメータを使⽤します。

LUN とホストの関連付け

Toolkit 1.4 で追加された Get-NaHostDisk コマンドレットを使⽤すると、Data ONTAP LUN に対応

するローカルホスト上のすべてのディスクを列挙できます。ホスト側とコントローラ側の両⽅の情報が表

⽰されます。このコマンドレットでは、Windows Server 2003 以降をサポートしています。

ホストディスクに関するその他の情報を Windows から取得するには、PowerShell WMI アクセラレー

タを使⽤します。

この情報に基づいて、そのあとの WMI クエリを実⾏することもできます。

Get-NaHostDisk は、Windows Server 2008 のフェイルオーバークラスタおよびクラスタ共有ボリュー

ムにも完全に対応しています。

Data ONTAP のサポートの更新 Toolkit 1.4 では、⼤規模アグリゲート、ボリューム移動、コピーオフロードなど、Data ONTAP のすべ

ての新機能を使⽤できます。ボリュームやアグリゲートを表す⼀部のコマンドレットの出⼒が更新され、

Data ONTAP の新しいリリースの情報も表⽰されるようになりました。この変更による⼤きな影響はあり

ません。

新しいコマンドレットのカテゴリ Toolkit 1.4 では、次の API カテゴリのサポートが追加されています。

copyoffload

flash

fpolicy

lock

rsh

エラー処理の強化パイプラインが終了するエラーのほとんどが、終了しないエラーに置き換えられました。これにより、終

了しないエラーにしか適⽤されない、PowerShell の-ErrorAction および$ErrorActionPreference のメカ

ニズムのサポートが向上しています。たとえば、Toolkit 1.3 では、DataONTAP 8.0.1 により次のような

エラーが返されます。

Toolkit 1.4 では、この動作が改善されています。

クォータのコマンドレットの簡易化 API の⼀部のパラメータが追加のパラメータセットで抽象化され、それらのコマンドレットが使いやすく

なりました。たとえば、ツリークォータの検索は、パスを指定するだけで実⾏できます。

新しいパラメータセットが追加されたコマンドレットは次のとおりです。

Add-NaQuota

Get-NaQuota

Remove-NaQuota

Set-NaQuota

Snapshot のコマンドレットの強化 Snapshot オブジェクトに、TargetName および TargetType という 2 つのフィールドが追加されました。

これにより、パイプラインのサポートが向上しています。

また、アグリゲート Snapshot を処理できる Snapshot のコマンドレットが増えました。次に主なものを

⽰します。

Get-NaSnapshot

Get-NaSnapshotReserve

New-NaSnapshot

Remove-NaSnapshot

Rename-NaSnapshot

Set-NaSnapshotReserve

Get-NaHyperV でのクラスタのサポートの強化 Windows Server 2008 フェイルオーバークラスタのホストで Get-NaHyperV を実⾏した場合に、その

クラスタで実⾏されているすべての仮想マシンに加え、Data ONTAP コントローラで提供されるそれらの

ストレージリソースもすべて⼀覧表⽰されるようになりました。

API ⼀覧表⽰コマンドレット Get-NaSystemApi を使⽤すると、コントローラの API が⼀覧表⽰されます。

Get-NaHelpUnsupported を使⽤すると、サポートされている API の⼀覧と Toolkit のコマンドレット

が関連付けられ、API がないために現在のコントローラでは機能しない Toolkit のコマンドレットの⼀覧

が返されます。たとえば、Data ONTAP 7.3.5 を実⾏しているコントローラでは、新しいボリューム移動

機能はサポートされません。

raw API の呼び出し Toolkit 1.4 の Invoke-NaSystemApi コマンドレットを使⽤すると、下位の Data ONTAP API インター

フェイスにアクセスできます。⼊⼒は、XML 形式の⽂字列または.NET XmlDocument オブジェクトです。

出⼒は、PowerShell で簡単にトラバースできる XmlDocument です。詳しい情報やドキュメントについ

ては、NetApp Manageability SDK を参照してください。

オプションのハッシュオプションを取得するコマンドレット（Get-NaAggrOption、Get-NaVolOption、Get-NaOption）で

は、スクリプトで簡単に使⽤できるように、出⼒をハッシュテーブルの形式で返すこともできます。

プロバイダの強化 Toolkit 1.4 の DataONTAP PowerShell プロバイダでは、ファイルのコピーや移動を⾏う際、可能な場合

はコピーオフロード機能が使⽤されます。また、アグリゲートのパスもサポートされます。

テーブルの列ヘッダーのエイリアス Toolkit 1.4 では、テーブルの列ヘッダーが、出⼒オブジェクトのフィールドに直接対応します。たとえば、

Toolkit 1.3 の場合、アグリゲートのテーブルは次のようになります。

Name、TotalSize、Available、および Disks のフィールドだけを選択した場合は次のようになります。

TotalSize、Available、および Disks は、実際には出⼒オブジェクトのフィールドではないため、名前で

参照した場合は空になります。Toolkit 1.4 の場合は、列ヘッダー（使⽤可能な限られたスペースに収まる

ように短縮されることが多い）のエイリアスとして設定されたソースフィールドの値が表⽰されます。


Get-NaCopyOffload

Start-NaCopyOffload

Stop-NaCopyOffload

Get-NaFlashDevice

Get-NaFlashProfile

Get-NaFlashThreshold

Add-NaFpolicyExtension

Disable-NaFpolicy

Enable-NaFpolicy

Get-NaFpolicy

Get-NaFpolicyExtensionList

Get-NaFpolicyOption

Get-NaFpolicySecondaryServer

Get-NaFpolicyServer

Get-NaFpolicyVolumeList

New-NaFpolicy

Remove-NaFpolicy

Remove-NaFpolicyExtension

Reset-NaFpolicyExtensionList

Set-NaFpolicy

Set-NaFpolicyExtensionList

Set-NaFpolicyOption

Set-NaFpolicySecondaryServer

Set-NaFpolicyVolumeList

Stop-NaFpolicyServer

Get-NaLockStatus

Invoke-NaSysstat

Disconnect-NaRshSession

Get-NaRshSession

Get-NaRshStatistics

Get-NaSystemApi

Invoke-NaSystemApi

Get-NaHelpUnsupported

Get-NaHostDisk

Get-NaVolMove

Invoke-NaVolMoveCutover

Resume-NaVolMove

Start-NaVolMove

Stop-NaVolMove

Suspend-NaVolMove

Toolkit 1.4 の解決済みの問題 system-cli API が vFiler に送信された場合に Data ONTAP がパニック状態になる問題の回避策が

追加されました。

配列を指定できるコマンドレットのワイルドカードパターンの問題が解決されました。

Data ONTAP で誤った⽇時の値が報告される問題の回避策が追加されました。


SSH の呼び出し Data ONTAP を管理するスクリプトを記述する際、コントローラのコマンドラインインターフェイスで

実⾏できるタスクに対応する API（コマンドレット）がない場合があります。残念ながら、CLI コマンド

の呼び出しをサポートする API は公開されていませんが、Data ONTAP は、SSH 接続を介した CLI コマン

ドを完全にサポートしています。そのためのコマンドレットとして、Toolkit 1.3 では Invoke-NaSsh が

提供されています。⼊⼒と出⼒は、書式設定されていない次のような⽂字列です。

Invoke-NaSsh では属性が宣⾔されるため、CLI コマンドで引⽤符を使⽤する必要はありません。ただし、

ハイフンを含む場合は、PowerShell のパーサーで正しく解釈されないことがあるため、引⽤符で囲みま

す。

Invoke-NaSsh では、Toolkit で標準の HTTP 接続や RPC 接続を使⽤している場合でも SSH 接続を使⽤

するため、コントローラの有効なクレデンシャルが必要になります。HTTP 接続または HTTPS 接続を使

⽤している場合は、Toolkit ですでに設定されているクレデンシャルが SSH にも使⽤されます。RPC を使

⽤している場合は、-Credential パラメータを明⽰的に指定するか、新しいクレデンシャルキャッシュメ

カニズムを暗黙的に使⽤して、クレデンシャルを別途指定する必要があります。

PowerShell のエイリアス機能を使⽤すると、Invoke-NaSsh をさらに簡易化できます。

また、無制限とまではいきませんが、Invoke-NaSsh では、Data ONTAP 以外の接続も⼀部サポートされます。-Name パラメータと-Credential パラメータを指定して、たとえば NetApp DataFabric Manager ホストなどにも SSH コマンドを送信することができます。

クレデンシャルキャッシュ

Toolkit 1.3 では、Connect-NaController と Invoke-NaSsh で、セキュアなクレデンシャルキャッシュがサポートされるようになりました。この機能により、HTTP または HTTPS を使⽤している場合も、RPC を使⽤した場合とほとんど変わらない簡単な⽅法で Toolkit を使⽤できます。クレデンシャルは、HTTP または HTTPS を使⽤してコントローラに接続し、Add-NaCredential を実⾏するだけで追加できます。

-Credential パラメータや-RPC パラメータで別の設定を明⽰的に指定しないかぎり、キャッシュに追加されたクレデンシャルが常に使⽤され、Connect-NaController で HTTP または HTTPS が使⽤されます。

クレデンシャルキャッシュでは、Windows の組み込みのデータ保護機能を使⽤します。クレデンシャルは、デフォルトでは現在のユーザのコンテキストで暗号化されます。つまり、それらのクレデンシャルを取得できるのはそのユーザだけになります。同じ Windows ホストに、複数のユーザがそれぞれ独⾃のク

レデンシャルを保存することも可能です。ローカルの Windows システムの任意のユーザまたはプロセスがクレデンシャルを取得できるようにするには、Add-NaCredential で-SystemScope パラメータを指定してクレデンシャルを保存します。システムスコープのクレデンシャルを保存すると、別のユーザアカウントでスクリプトを実⾏する場合に便利です。ただし、ログインしているすべてのユーザがクレデンシャルにアクセスできるようになるため、この⽅法は、アクセスが制限された Windows ホストでのみ使⽤してください。

クレデンシャルキャッシュは、ApplianceWatch 2.1 に付属のコマンドレットと相互に連携して動作するように設計されています。ただし、ApplianceWatch では、システムスコープのクレデンシャルしか格納できません。

クレデンシャルは、ユーザスコープとシステムスコープのどちらで保存されているかに関係なく、保存

された Windows ホストでのみ暗号化されます。したがって、クレデンシャルキャッシュファイルをコ

ピーして他のホストで使⽤することはできません。

特定のコントローラについて、キャッシュに現在のユーザとシステムの両⽅のエントリが格納されている

場合、次の例に⽰すように、ローカルユーザスコープのエントリが優先的に使⽤されます。

クレデンシャルキャッシュは、次のようにして簡単に空にすることができます。

FlexShare Toolkit 1.3 では、Data ONTAP のボリュームベースの Quality of Service（QoS;サービス品質）ツールで

ある FlexShare をサポートするコマンドレットが 8 つ追加されています。これらのコマンドレットは、

「優先度」カテゴリに分類されます。

PowerShell プロバイダ PowerShell プロバイダでは、ファイルシステム、レジストリ、証明書ストアなど、各種のリソースにア

クセスできます。Toolkit 1.3 では、試験的に、Data ONTAP 向けの PowerShell プロバイダが導⼊されて

います。この Data ONTAP 向けプロバイダを使⽤すると、Data ONTAP ファイルシステムのファイルや

ディレクトリに、Windows のローカルディスクと同じセマンティクスを使⽤してアクセスできます。こ

のプロバイダを使⽤するのに、CIFS などの特定のプロトコルのライセンスは必要ありません。このプロ

バイダは ManageONTAP SDK に基づくため、CIFS アクセスに⽐べると I/O 処理に時間がかかり、主に

管理タスクに適しています。

このプロバイダは、DataONTAP モジュールをインポートすると⾃動的にロードされます。

このプロバイダを使⽤するには、まず、Data ONTAP コントローラに接続します。

次に、PSDrive オブジェクトを作成します。そのあと、現在の作業ディレクトリを新しいドライブに変更

します。

ファイルの⼀覧表⽰や操作に使⽤する各種のコマンドは、ほとんどが適切に動作します。/etc ディレクト

リは、ルートボリュームの etc ディレクトリへのショートカットです。PowerShell プロバイダのドライ

ブには PowerShell からしかアクセスできないことに注意してください。

要望が多かった次の処理も可能になっています。

バイナリファイルを Data ONTAP に転送するときは、-Encoding パラメータと-ReadCount パラメータ

を次のように指定します。

バイナリファイルを Data ONTAP から転送するときは、-Encoding パラメータを次のように指定します。

Data ONTAP PowerShell プロバイダでは、FileSystem プロバイダにならい、いくつかの動的パラメータ

がサポートされています。

–Encoding

o Unknown。エンコードの種類が不明であるか無効です。データはバイナリとして扱われます

o String。⽂字列⽤の種類のエンコードを使⽤します

o Unicode。リトルエンディアンバイトオーダーを使⽤して UTF-16 形式でエンコードします

o Byte。⽂字セットを⼀連のバイトにエンコードします

o BigEndianUnicode。ビッグエンディアンバイトオーダーを使⽤して UTF-16 形式でエン

コードします

o UTF8。UTF-8 形式でエンコードします

o UTF7。UTF-7 形式でエンコードします

o ASCII。ASCII（7 ビット）⽂字セット⽤のエンコードを使⽤します。デフォルトでは

ASCII を使⽤します

o サポートされるコマンドレット：Add-Content、Get-Content、Set-Content

–Delimiter

o ファイルに書き込む際に使⽤する⾏区切り⽂字を指定します。デフォルトは「\n」（改⾏）

です

o サポートされるコマンドレット：Add-Content、Set-Content

このプロバイダは試験的に導⼊されたものですが、⼤幅な変更が⽣じることはないと想定しています。使

⽤⽅法や改善点について、皆様からのご意⾒をお待ちしております。

ShouldProcess PowerShell のコマンドレットでは、確認と-WhatIf パラメータの処理に、ShouldProcess という組み込

みのメカニズムを使⽤します。ShouldProcess は以前のリリースの Toolkit でもサポートされていました

が、対象となるコマンドレットはユーザの確認が必要になるものがほとんどでした。Toolkit 1.3 では、

Get 以外のすべてのコマンドレットに対応するように ShouldProcess のサポートが拡張され、-WhatIf パ

ラメータを広く利⽤できるようになりました。

対象となるコマンドレットのほとんどは ConfirmImpact.Low に設定されますが、PowerShell のデフォ

ルトの確認レベルは Medium であるため、この変更が既存のスクリプトに影響することはほとんどありま

せん。

ToString Toolkit のコマンドレットから返されるすべての種類のオブジェクトについて、ToString()メソッドが無効

になり、Toolkit の出⼒が読みやすくなりました。以前の出⼒の例を次に⽰します。

この出⼒が次のように変わり、少し読みやすくなりました。

注意が必要なのは、表⽰されている内容が単なる⽂字列なのか、もっと⼤きなオブジェクトなのかがわか

りにくいことです。Toolkit の出⼒を確認するときは、Get-Member を使⽤して、より詳しい内容を確認

することを推奨します。

ソート

Get コマンドレットの多くで、出⼒が名⽬上のフィールドを基準にソートされるようになりました。以前

の出⼒の例を次に⽰します。

この出⼒が、パスを基準に⾃動的にソートされるようになりました。

接続の強化 Connect-NaController に、Toolkit の接続で使⽤されるプロトコルをより明⽰的に制御できるように、3

つの新しいパラメータ（-RPC、-HTTP、-HTTPS）が追加されています。利⽤できるクレデンシャルがな

い場合は以前と同様に RPC がデフォルトで使⽤されますが、クレデンシャルキャッシュが追加されたこ

とで、-Credential パラメータが指定されていない場合に常に RPC が使⽤されるとは限らなくなりました。

以前の-ForceSecure パラメータと-ForceUnsecure パラメータは廃⽌されましたが、パラメータのエイ

リアスを使⽤すれば引き続き機能します。

Connect-NaController には、さらに、確⽴された接続を使⽤する Toolkit のすべてのコマンドレットに

影響する-Timeout パラメータも追加されています。このパラメータはミリ秒で指定し、HTTP 接続と

HTTPS 接続のみに影響します。デフォルト値は 10 秒です。

Windows の HTTP プロキシ設定が原因で Toolkit の接続を確⽴できないという問題が何件か報告されたた

め、Toolkit 1.3 では、HTTP プロキシ設定を無視するようにしています。

パラメータのエイリアス PowerShell の多くのコマンドレットでパラメータのエイリアスがサポートされますが、エイリアスを検

出する⽅法が明確でありません。Toolkit 1.3 では、Get-NaHelpAlias というコマンドレットが追加され、

パラメータのエイリアスを表⽰できるようになりました。このコマンドレットは、Toolkit のコマンドレッ

トだけでなく、すべてのコマンドレットで機能します。


Disable-NaPriority

Enable-NaPriority

Get-NaPriority

Get-NaPriorityDefault

Get-NaPriorityVolume

Set-NaPriority

Set-NaPriorityDefault

Set-NaPriorityVolume

Set-NaQtree

Add-NaCredential

Get-NaCredential

Remove-NaCredential

Mount-NaController

Dismount-NaController

Invoke-NaSsh

Get-NaHelpAlias

Toolkit 1.3 の解決済みの問題 Get-NaQtree で、ボリューム全体の qtree を選択できるようになりました。

Toolkit で HTTP 接続にプロキシが使⽤されなくなりました。

Start-NaSnapvaultSecTransfer および Start-NaSnapvaultPriRestoreTransfer で、ソー

ス Snapshot を指定できるようになりました。


データフォーマッタ

Toolkit 1.2 のデータフォーマッタは、スクリプト操作には影響しません。Toolkit の CLI ツールとしての有⽤性を⾼めるために、⼀般的な種類のオブジェクトを表形式で出⼒し、役⽴つフィールドだけを表⽰するように設計されています。

以前のリリースの Toolkit を使⽤した場合の出⼒の例を次に⽰します。

Toolkit 1.2 では、この出⼒が次のようになります。

データフォーマッタは、1 ⾏に 120 ⽂字まで表⽰できるように最適化されています。デフォルトのシェル

幅を設定するには、PowerShell プロファイルを次のように変更します。

必要に応じて、Toolkit モジュールのインストールディレクトリ

（C:\Windows\System32\WindowsPowerShell\v1.0\Modules\DataONTAP）にある

DataONTAP.Format.ps1xml ファイルを変更して、データフォーマッタをカスタマイズすることもできま

す。このファイルを編集する場合は、Toolkit の以降の更新でファイルが上書きされるため、変更内容の

バックアップ複製を別の場所に保存しておくようにしてください。

また、フォーマッタにより、⼀般的な多くの種類のオブジェクトについて、リストビューや横⻑のビュー

が合理化されます。書式設定されていないオブジェクトを表⽰するには、次のコマンドを使⽤します。

Microsoft Hyper-V の統合 Toolkit 1.2 の Get-NaHyperV という新しいコマンドレットを使⽤すると、Data ONTAP のストレージリ

ソースを利⽤するローカルホスト上の Hyper-V 仮想マシンをすべて列挙できます。該当する仮想マシン

のそれぞれについて、仮想環境でのスクリプトの記述に役⽴つ、関連するホストおよびコントローラのす

べての情報が⼀覧表⽰されます。このコマンドレットでは、VHD ファイルとパススルーディスクの両⽅

に加え、クラスタ共有ボリュームもサポートされます。次に例を⽰します。

Get-NaHyperV にはクレデンシャルは必要ありませんが、Hyper-V の役割がインストールされている必要

があります。ストレージの照会や操作をさらに⾏う場合、フィールドまたはフィールドの戻り値をに渡すこ

とができます。

ネットワークの設定多くの要望に応え、Toolkit 1.2 では、ネットワークインターフェイス、VLAN、VIF、ルート、および

IPspace の設定に使⽤できる 20 個のコマンドレットが追加されました。ネットワークの設定を変更する

コマンドレットはいずれも、アクティブな設定と/etc/rc に保存されている永続的な設定の両⽅を変更する

ように設計されています。これにより、すべての変更がリブート後も維持されます。/etc/rc のネットワー

ク以外の項⽬は、Data ONTAP で保持されます。ネットワーク関連の新しいコマンドレットのほとんどで

は、Data ONTAP 7.3.3 以降が必要です。Data ONTAP 8.x リリースではまだサポートされていません。

新しいコマンドレット Data ONTAP PowerShell Toolkit 1.2 で新たに追加されたコマンドレットを次に⽰します。これらの多く

では、Data ONTAP 7.3.3 以降で新たに追加された API が必要です。Data ONTAP 8.x ではまだ使⽤でき

ません。

Get-NaCifsShareAcl

Remove-NaCifsShareAcl

Set-NaCifsShareAcl

Clear-NaLunPersistentReservation

Get-NaLunPersistentReservation

Set-NaLunDeviceId

Get-NaLunSelect

Set-NaLunSelect

Add-NaNetRoute

Add-NaNetVlan

Get-NaNetActiveConfig

Get-NaNetInterface

Get-NaNetIpspace

Get-NaNetPersistentConfig

Get-NaNetRoute

Get-NaNetVif

Get-NaNetVlan

New-NaNetIpspace

New-NaNetVif

Remove-NaNetIpspace

Remove-NaNetRoute

Remove-NaNetVif

Remove-NaNetVlan

Set-NaNetInterface

Set-NaNetIpspace

Set-NaNetPersistentConfig

Set-NaNetVif

Set-NaNetVlan

Get-NaShelf

Get-NaShelfEnvironment

Set-NaShelfLight

Start-NaShelfUpdate

Get-NaSystemAvailableReplicationTransfers

ConvertTo-FormattedNumber

Get-NaHyperV

Get-NaToolkitVersion

Get-NaVolCloneSplitEstimate

Toolkit 1.2 の解決済みの問題 NfsTopInfo で getattr-ops のデータが表⽰されない。

perf InstanceData で timestamp フィールドが表⽰されない。

SnapVault の最⼤転送速度が正しくない。

(Reference-PSTK)Making the Most of Data ONTAP PowerShell Toolkit_jaJP_loMaking The Most Of Data...

Documents

Transcript of (Reference-PSTK)Making the Most of Data ONTAP PowerShell Toolkit_jaJP_loMaking The Most Of Data...