Windows PowerShell によるキャッシュ構成 (Windows Server AppFabric キャッシング)

Windows Server AppFabric キャッシュ サービスを構成するには、2 とおりの方法があります。AppFabric 構成ウィザードのユーザー インターフェイスと、AppFabric キャッシング用の一連の Windows PowerShell コマンドです。このトピックでは、Windows PowerShell コマンドについて説明します。AppFabric 構成ウィザードの使用方法の詳細については、「Windows Server AppFabric の構成」を参照してください。

キャッシュ管理機能がインストールされたコンピューターを使用している場合、AppFabric のキャッシュ機能を管理するために Windows PowerShell を起動するには、2 とおりの方法があります。[スタート] ボタンをクリックし、[管理ツール] をクリックして、[Windows PowerShell モジュール] を選択します。または、[スタート] ボタンをクリックし、[すべてのプログラム]、[Windows Server AppFabric]、[Windows PowerShell のキャッシュ管理] の順にクリックします。

ヒント

Windows Vista、Windows 7、および Windows Server 2008 オペレーティング システムでは、一部の構成コマンドを正しく動作させるために、管理者特権で Windows PowerShell を実行する必要があります。[Windows PowerShell のキャッシュ管理] のショートカットを使用する場合は、ショートカットを右クリックし、[管理者として実行] を選択する必要があります。

Windows PowerShell セッションでのヘルプの表示

AppFabric のキャッシュ機能に関係する管理コマンドの概要を以下に示します。Windows PowerShell セッション内からでもヘルプを表示できることを知っておくことが重要です。たとえば、次のコマンドを入力すると、すべての構成コマンドが表示されます。

get-command -module DistributedCacheConfiguration

特定のコマンドについてヘルプを参照する必要がある場合は、get-help コマンドを使用して表示できます。たとえば、次のコマンドを入力すると、Add-CacheHost コマンドの詳細なヘルプが表示されます。

get-help Add-CacheHost -full

構成コマンド

AppFabric キャッシング用の PowerShell コマンドには 2 つの主なカテゴリがあります。管理コマンドと構成コマンドです。このトピックでは、構成コマンドについて説明します。管理コマンドの詳細については、「Windows PowerShell を使用した Windows Server AppFabric キャッシュ機能の管理」を参照してください。次の表は、キャッシュ サービスを構成するために使用できる Windows Powershell のキャッシュ管理コマンドの一覧です。

コマンド 説明

Add-CacheAdmin

キャッシュ ホストにキャッシュ管理を構成します。このコマンドはサーバー上でローカルに動作します。

Add-CacheHost

キャッシュ ホストを既存のクラスターの一部になるように構成します。このコマンドはサーバー上でローカルに動作します。

Get-CacheClusterInfo

キャッシュの初期化状態とサイズに関する詳細を含む、キャッシュ クラスター情報を返します。

Get-CacheConnectionString

Set-CacheConnectionString コマンドで設定された一時的な接続文字列を返します。このコマンドはキャッシュ クラスター構成ストアで使用されている接続文字列を表すとは限らないことに注意してください。

ヒント

このコマンドは Windows Server AppFabric によって内部的に使用されます。このコマンドを使用することが必要な既知のユーザー シナリオはありません。

New-CacheCluster

新しいキャッシュ クラスター構成ストアを作成し、初期化します。

Register-CacheHost

指定されたキャッシュ クラスター構成ストアにキャッシュ ホストを追加します。

Remove-CacheAdmin

キャッシュ ホストからキャッシュ管理の構成を削除します。このコマンドはサーバー上でローカルに動作します。

Remove-CacheCluster

既存のクラスター構成を削除します。

Remove-CacheHost

現在キャッシュ クラスターのメンバーになっていないキャッシュ ホストの構成を削除します。このコマンドはサーバー上でローカルに動作します。

Set-CacheConfigurationLog

構成コマンドのログ記録に使用するカスタム ログ ファイルの場所を設定します。既定では、ログは Temp フォルダーに作成されます。

Set-CacheConnectionString

一時的に使用する接続文字列を保持します。その後、Get-CacheConnectionString でこの文字列を取得できます。このコマンドはキャッシュ クラスター構成ストアで使用されている接続文字列を変更しないことに注意してください。

ヒント

このコマンドは Windows Server AppFabric によって内部的に使用されます。このコマンドを使用することが必要な既知のユーザー シナリオはありません。

Test-CacheClusterConnection

キャッシュ クラスター構成ストアへの接続をテストします。

Unregister-CacheHost

キャッシュ クラスター構成ストアからキャッシュ ホスト エントリを削除します。現在のホストが登録解除された場合、HostName パラメーターは必要ありません。この場合、Provider および ConnectionString パラメーターも省略可能です。ただし、現在のキャッシュ ホストが構成されており、Remove-CacheHost コマンドがキャッシュ ホストで呼び出されていないことが前提です。

関連項目

概念

Windows PowerShell を使用した Windows Server AppFabric キャッシュ機能の管理
構成の設定 (Windows Server AppFabric キャッシュ)
Windows Server AppFabric キャッシュ構成オプション
Windows Server AppFabric キャッシュのトラブルシューティング
Windows Server AppFabric のキャッシュの概念
キャッシュ クライアントを開発する (Windows Server AppFabric キャッシュ)

  2011-12-05