Windows Server 2012では、Windows Server 2008 R2からActive Directory (AD)やフェールオーバー クラスタリング (WSFC) といったサーバー管理におけるPowerShellコマンドレットが強化、および追加されました。
各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、現時点では主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、Windows Server 2012のWSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、補足したものとなります)。
この記事では、「Stop-ClusterResource」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2012のWSFCで使用できるPowerShellコマンドレットについて」を参照)。
■名前
Stop-ClusterResource
■概要
スケールアウト アプリケーション データ用のクラスタ化されたファイル サーバーを作成します。
■構文
Add-ClusterScaleOutFileServerRole [[-Name] <string>] [-Wait32 <int>] [-InputObject <psobject>] [-Cluster <string>] [<CommonParameters>]
■説明
Stop-ClusterResourceコマンドレットは、スケールアウト アプリケーション データ用のクラスタ化されたファイル サーバーを作成します。
ファイルを長期間オープン状態となるアプリケーションまたはバーチャル・マシンに、スケールアウト アプリケーション データのためのファイル サーバーは記憶域を提供します。 クライアント接続は、より良いスループットのためにノードに対して配布されます。 この種のファイル サーバーは、サーバー メッセージ ブロック (SMB) プロトコルをサポートします。 それは、ネットワーク ファイル システム (NFS) プロトコルまたは特定の役割サービス (例えばファイル サーバー リソース マネージャー (FSRM)または分散ファイル システム (DFS) 複製) をサポートしません。
注: このコマンドレットは、Credential Security Service Provider (CredSSP) 認証なしで、サーバー コンピューター上からリモートで実行することはできません。
■パラメーター
-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。
| エイリアス | なし |
| 必須 | false |
| 位置 | named |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InputObject <psobject>
オフラインに移行するクラスター リソースを指定します。
| エイリアス | なし |
| 必須 | false |
| 位置 | named |
| 既定値 | なし |
| パイプライン入力を許可する | true (ByValue) |
| ワイルドカード文字を許可する | false |
-Name <string>
停止するクラスター リソースの名前を指定します。また、クラスター共有ボリュームの名前も指定できます。
| エイリアス | なし |
| 必須 | false |
| 位置 | 1 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Wait <int32>
操作の待機時間を秒単位で指定します。このパラメーターが指定されていない場合は、操作が完了するまで待機します。”-Wait 0″を指定した場合、呼び出しが開始され、すぐにコマンドレットに戻ります。
| エイリアス | なし |
| 必須 | false |
| 位置 | named |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、および-OutVariable。詳細については、「about_commonparameters」と入力してヘルプを参照してください。
■入力
System.Management.Automation.PSObject
■出力
System.Object
■エイリアス
なし
■メモ
このコマンドレットを含むモジュールのヘルプ ファイルをダウンロードしてインストールするには、Update-Helpを使用してください。
このコマンドレットのヘルプ トピックをオンラインで確認するには、「Get-Help Add-ClusterScaleOutFileServerRole -Online」と入力するか、http://go.microsoft.com/fwlink/?LinkId=216200を参照してください。
■例
例1
Add-ClusterScaleOutFileServerRole
例1:出力結果
| Name OwnerNode State —- ——— —– clusterSOFS CLUSTER-N2 Online |
例1:説明
このコマンドは、高可用性のスケールアウト ファイル サーバー役割を作成します。
例2
Add-ClusterScaleOutFileServerRole -Wait 0
例2:出力結果
| Name OwnerNode State —- ——— —– clusterSOFS CLUSTER-N2 Pending |
例2:説明
このコマンドは、高可用性のスケールアウト ファイル サーバー役割を作成します。また、このコマンドはすべてのリソースがオンラインになるのを待たずに完了します。
■関連するリンク
- Add-ClusterFileServerRole
- Get-ClusterGroup
- Move-ClusterGroup
- Remove-ClusterGroup
- Start-ClusterGroup
- Stop-ClusterGroup
[参考]
- Add-ClusterScaleOutFileServerRole – Windows Server 2012
http://technet.microsoft.com/en-us/library/hh847286.aspx - Windows PowerShell Support for Windows Server 2012
http://technet.microsoft.com/en-us/library/hh801904.aspx - Failover Clusters Cmdlets in Windows PowerShell – Windows Server 2012
http://technet.microsoft.com/en-us/library/hh847239.aspx
コメント
[…] Add-ClusterScaleOutFileServerRole […]