Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレット (Set-ClusterResourceDependency) について

Windows Server 2008 R2では、Active Directory (AD) やフェールオーバー クラスタリング (WSFC)、グループ ポリシーといった役割および機能がインストールされたサーバーの管理、もしくは管理したい役割および機能についてリモート サーバー管理ツールをインストールしたサーバー上で、PowerShellコマンドレットを用いて管理することが可能です。

各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、主に英語のみで日本語の情報はあまり公開されていないようです。

ここでは、WSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。

この記事では、「Set-ClusterResourceDependency」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレットについて」を参照)。

■名前

Set-ClusterResourceDependency

■概要

フェールオーバー クラスター内で特定のリソースが依存するリソースを指定します。既存の依存関係は、指定した依存関係によって上書きされます。

■構文

■説明

依存関係を記述する式では”or”を使用できます。”or”を使用する例としては、Network Nameリソースが2つのIPアドレス リソースの (両方ではなく) どちらかに依存するよう依存関係を設定する場合が挙げられます。マルチサイト クラスター展開では、”or”に基づく依存関係を使用するのが一般的です。

■パラメーター

-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。

-Dependency <string>
このリソースを設定する対象の依存関係式を指定します。この場合の形式は、文字列”[Resource Name 1] [and|or [Resource Name 2] […] ]”です。リソース名は、[Cluster Disk 2]のように角かっこで囲みます。例を参照してください。リソース依存関係をリセットするには、このパラメーターで空の文字列””を使用します。

-InputObject <psobject>
依存関係式を設定する対象のクラスター リソースを指定します。

-Resource <string>
依存関係式を設定する対象のクラスター リソースの名前を指定します。

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

Microsoft.FailoverClusters.PowerShell.ClusterResource

■出力

■メモ

■例

例1

 Set-ClusterResourceDependency cluster1FS12 "[IP Address 151.56.48.0]" 

例1:説明

このコマンドは、cluster1FS12というリソースを [IP Address 151.56.48.0] に依存するよう設定します。

例2

 Set-ClusterResourceDependency cluster1FS12 "[IP Address 151.56.48.0] or [New IP Address]" 

例2:説明

このコマンドは、cluster1FS12というリソースを [IP Address 151.56.48.0] または [New IP Address] に依存するよう設定します。

例3

 Set-ClusterResourceDependency cluster1FS12 "" 

例3:説明

このコマンドはリソースcluster1FS12が他のリソースに依存しないように、依存関係一覧をクリアします。

■関連するリンク

• Add-ClusterResourceDependency
• Get-ClusterResourceDependency
• Remove-ClusterResourceDependency
• Get-ClusterResourceDependencyReport

[参考]

• Set-ClusterResourceDependency
  http://technet.microsoft.com/en-us/library/ee461029.aspx
• Cmdlet Reference for Windows Server 2008 R2
  http://technet.microsoft.com/en-us/library/ee407531.aspx
• Failover Cluster Cmdlets in Windows PowerShell
  http://technet.microsoft.com/en-us/library/ee461009.aspx
• Getting Started with Windows PowerShell on a Failover Cluster
  http://technet.microsoft.com/en-us/library/ee619762.aspx