Windows Server 2012のWSFCで使用できるPowerShellコマンドレット (Get-Cluster) について

スポンサーリンク

Windows Server 2012では、Windows Server 2008 R2からActive Directory (AD)やフェールオーバー クラスタリング (WSFC) といったサーバー管理におけるPowerShellコマンドレットが強化、および追加されました。

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

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

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

■名前

Get-Cluster

■概要

対象のドメイン内の1つまたは複数のフェールオーバー クラスターに関する情報を取得します。

■構文

Get-Cluster [[-Name] <string>] [-Domain <string>]  [<CommonParameters>]

■説明

Get-Clusterコマンドレットは、対象のドメイン内の1つまたは複数のフェールオーバー クラスターに関する情報を取得します。

このコマンドレットは、フェールオーバー クラスターに関するさまざまな構成および状態の情報を取得できます。具体的な情報としては、次の項目が挙げられます。

  • バックアップが進行中であるかどうかについての状態情報
  • クラスターが強制的にクォーラム状態になっているかどうかについての状態情報
  • 特にマルチサイト クラスターに関連するクロスネットワーク設定

クラスターの共通のプロパティを設定するには、このコマンドレットを使用してクラスター オブジェクトを取得し、そのクラスター オブジェクトに適切なプロパティを直接設定します。

■パラメーター

-Domain <string>
クラスターを列挙する対象のドメインの名前を指定します。

エイリアス なし
必須 false
位置 named
既定値 なし
パイプライン入力を許可する false
ワイルドカード文字を許可する false

-Name <string>
取得するクラスターの名前を指定します。

エイリアス なし
必須 false
位置 1
既定値 なし
パイプライン入力を許可する false
ワイルドカード文字を許可する false

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

■入力

なし

■出力

System.Object

■エイリアス

なし

■メモ

このコマンドレットを含むモジュールのヘルプ ファイルをダウンロードしてインストールするには、Update-Helpを使用してください。

このコマンドレットのヘルプ トピックをオンラインで確認するには、「Get-Help Get-Cluster -Online」と入力するか、http://go.microsoft.com/fwlink/?LinkId=216206を参照してください。

■例

例1

 Get-Cluster | fl * 

例1:出力結果

Domain                                  : contoso.com
Name                                    : cluster1
AddEvictDelay                           : 60
BackupInProgress                        : 0
ClusSvcHangTimeout                      : 60
ClusSvcRegroupOpeningTimeout            : 5
ClusSvcRegroupPruningTimeout            : 5
ClusSvcRegroupStageTimeout              : 5
ClusSvcRegroupTickInMilliseconds        : 300
ClusterGroupWaitDelay                   : 120
MinimumNeverPreemptPriority             : 3000
MinimumPreemptorPriority                : 1
ClusterEnforcedAntiAffinity             : 0
ClusterLogLevel                         : 3
ClusterLogSize                          : 300
CrossSubnetDelay                        : 1000
CrossSubnetThreshold                    : 5
DefaultNetworkRole                      : 2
Description                             :
FixQuorum                               : 0
HangRecoveryAction                      : 3
IgnorePersistentStateOnStartup          : 0
LogResourceControls                     : 0
PlumbAllCrossSubnetRoutes               : 0
PreventQuorum                           : 0
QuorumArbitrationTimeMax                : 20
RequestReplyTimeout                     : 60
RootMemoryReserved                      : 4294967295
RouteHistoryLength                      : 0
SameSubnetDelay                         : 1000
SameSubnetThreshold                     : 5
SecurityLevel                           : 1
SharedVolumeCompatibleFilters           : {}
SharedVolumeIncompatibleFilters         : {}
SharedVolumesRoot                       : C:ClusterStorage
SharedVolumeSecurityDescriptor          : {1, 0, 4, 128…}
ShutdownTimeoutInMinutes                : 20
UseNetftForSharedVolumes                : 1
UseClientAccessNetworksForSharedVolumes : 0
SharedVolumeBlockCacheSizeInMB          : 0
WitnessDatabaseWriteTimeout             : 300
WitnessRestartInterval                  : 15
EnableSharedVolumes                     : Enabled
DynamicQuorum                           : 1
Id                                      : af5881ef-0ff7-4b5c-bfed-098decbbf762

例1:説明

このコマンドは、ローカル クラスターの状態およびプロパティに関する情報を一覧形式で表示します。

例2

 Get-Cluster cluster1 

例2:出力結果

Name
—-
cluster1

例2:説明

このコマンドは、cluster1という名前のクラスターに関する情報を取得します。

例3

 Get-Cluster -domain contoso.com 

例3:出力結果

Name
—-
cluster1
cluster2
cluster3

例3:説明

このコマンドは、contoso.comドメイン内の各クラスターに関する情報を取得します。

例4

 $cluster = Get-Cluster; $cluster.CrossSubnetDelay = 1500 

例4:説明

このコマンドは、ローカル クラスターの共通のプロパティ CrossSubnetDelay を 1500 に設定します。また、以下のコマンドレットを実行して、そのプロパティを設定することもできます。

 Get-Cluster | %{ $_.CrossSubnetDelay = 1500 } 

コマンドが正常に完了した場合は、何も出力されません。

例5

 (Get-Cluster).DynamicQuorum = 1 

例5:説明

このコマンドは、クラスタ用の動的クォーラム機能を有効にします。

コマンドが正常に完了した場合は、何も出力されません。

■関連するリンク

  • New-Cluster
  • Remove-Cluster
  • Start-Cluster
  • Stop-Cluster
  • Test-Cluster
  • ForEach-Object
  • Format-List

[参考]

スポンサーリンク
スポンサーリンク
スポンサーリンク