Windows Server 2012 では、Windows Server 2008 R2 から Active Directory (AD) やフェールオーバー クラスタリング (WSFC) といったサーバー管理における PowerShell コマンドレットが強化、および追加されました。
各役割および機能に関する PowerShell コマンドレットのヘルプについて、オンライン上で公開されていますが、現時点では主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、Windows Server 2012 の WSFC に関する PowerShell コマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、補足したものとなります)。
この記事では、「Update-ClusterIPResource」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2012 の WSFC で使用できる PowerShell コマンドレットについて」を参照)。
Update-ClusterIPResource について
■名前
Update-ClusterIPResource
■概要
フェールオーバー クラスター内の IP アドレス リソースの DHCP リースを更新または解放します。
■構文
Update-ClusterIPResource [[-Name] <string>] [-Renew] [-Release] [-InputObject <psobject>] [-Cluster <string>] [<CommonParameters>]
■説明
Update-ClusterIPResource コマンドレットは、フェールオーバー クラスター内のIPアドレス リソースのDHCPリースを更新または解放します。
このコマンドレットは、DHCP を使用する IP アドレス リソースに対してのみ適用されます。
■パラメーター
-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-InputObject <psobject>
更新するクラスター IP アドレス リソースを指定します。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | true (ByValue) |
ワイルドカード文字を許可する | false |
-Name <string>
更新するクラスター IP アドレス リソースの名前を指定します。
エイリアス | なし |
必須 | false |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Release
コマンドレットにより、IP アドレス リソースの DHCP リースが解放されます。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Renew
コマンドレットにより、IP アドレス リソースの DHCP リースが更新されます。
エイリアス | なし |
必須 | 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 Update-ClusterIPResource -Online」と入力するか、http://go.microsoft.com/fwlink/?LinkId=216264を参照してください。
■例
例1
Update-ClusterIPResource &quot;Cluster IP Address&quot;
例1:出力結果
Name State Group ResourceType —- —– —– ———— Cluster IP Address Online Cluster Group IP Address |
例1:説明
“Cluster IP Address” というリソースに DHCP が割り当てられている場合、このコマンドはそのリソースの DHCP リースを更新します。
例2
Get-ClusterResource | ?{ $_.ResourceType.Name -eq &quot;IP Address&quot; } | Update-ClusterIPResource
例2:出力結果
Name State Group ResourceType —- —– —– ———— Cluster IP Address Online Cluster Group IP Address IP Address 172.2… Online cluster1-Other IP Address IP Address 172.2… Online cluster1-FS IP Address |
例2:説明
このコマンドは、DHCP が割り当てられているすべてのクラスター化された IP リソースの DHCP リースを更新します。
例3
Get-ClusterResource &quot;IP Address 172.24.11.0&quot; | Stop-ClusterResource | Update-ClusterIPResource -Release
例3:出力結果
Name State Group ResourceType —- —– —– ———— IP Address 172.2… Offline cluster1-Other IP Address |
例3:説明
このコマンドはリソース “IP Address 172.24.11.0” をオフラインに移行し、そのリソースの DHCP リースを解放します。
■関連するリンク
- Get-ClusterResource
- Update-ClusterNetworkNameResource
- Where-Object
参考
- Update-ClusterIPResource (FailoverClusters) – Windows Server 2012 | Microsoft Learn
https://learn.microsoft.com/ja-jp/powershell/module/failoverclusters/update-clusteripresource?view=winserver2012-ps - FailoverClusters Module – Windows Server 2012 PowerShell | Microsoft Learn
https://learn.microsoft.com/en-us/powershell/module/failoverclusters/?view=winserver2012-ps - Windows PowerShell Support for Windows Server 2012
http://technet.microsoft.com/en-us/library/hh801904.aspx
コメント
[…] Update-ClusterIPResource […]