Windows PowerShell によるキャッシュ構成 (AppFabric 1.1 キャッシュ)

[アーティクル]
04/05/2012

Microsoft AppFabric 1.1 for Windows Server キャッシュサービスの構成には 2 つの方法があります。 AppFabric 構成ウィザードのユーザーインターフェイスと、. このトピックでは、Windows PowerShell コマンドについて説明します。 AppFabric 構成ウィザードの使用方法の詳細については、「AppFabric の構成.

キャッシュ管理機能がインストールされたコンピューターを使用している場合は、[スタート] ボタンをクリックし、[すべてのプログラム]、, 、[Windows PowerShell のキャッシュ管理] の順にクリックします。. 次に、構成コマンドを含む Windows PowerShell モジュールを手動でインポートする必要があります。これについて、次の例で説明します。

Import-Module DistributedCacheConfiguration

ヒント

一部の管理コマンドを正しく動作させるために、管理者特権で Windows PowerShell を実行する必要があります。[Windows PowerShell のキャッシュ管理 ] のショートカットを使用する場合は、ショートカットを右クリックし、[管理者として実行] を選択します。.

AppFabric 1.1 用の 2012 年 3 月の更新プログラムの更新内容には、. これらの変更によって、コマンドのわかりやすさと一貫性が改善されます。次の表に、元のコマンド名 (RTM) と 2012 年 3 月の更新プログラムでのコマンド名を示します。

下位互換性を維持するために、旧コマンド名による新しいコマンドのエイリアスを使用するための PowerShell スクリプトが提供されています。すべてのパラメーター名の変更は、PowerShell モジュール自体の中でエイリアスが使用されます。

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

. Windows PowerShell セッション内からでもヘルプを表示できることを知っておくことが重要です。たとえば、次のコマンドを入力すると、すべての構成コマンドが表示されます。

get-command -module DistributedCacheConfiguration

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

get-help Add-CacheHost -full

構成コマンド

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

コマンド (RTM)	コマンド (QFE)	説明
`Add-CacheAdmin`	`Add-AFCacheAdminLocalConfiguration`	キャッシュホストにキャッシュ管理を構成します。このコマンドはサーバー上でローカルに動作します。
`Add-CacheHost`	`Add-AFCacheHostLocalConfiguration`	キャッシュホストを既存のクラスターの一部になるように構成します。このコマンドはサーバー上でローカルに動作します。
`Get-CacheClusterInfo`	`Get-AFCacheCluster`	キャッシュの初期化状態とサイズに関する詳細を含む、キャッシュクラスター情報を返します。
`Get-CacheConnectionString`	`Get-AFCacheTemporaryConnectionString`	Set-CacheConnectionString コマンドで設定された一時的な接続文字列を返します。このコマンドはキャッシュクラスター構成ストアで使用されている接続文字列を表すとは限らないことに注意してください。ヒントこのコマンドは、. このコマンドを使用することが必要な既知のユーザーシナリオはありません。
`New-CacheCluster`	`New-AFCacheClusterConfiguration`	新しいキャッシュクラスター構成ストアを作成し、初期化します。
`Register-CacheHost`	`Register-AFCacheHost`	指定されたキャッシュクラスター構成ストアにキャッシュホストを追加します。
`Remove-CacheAdmin`	`Remove-AFCacheAdminLocalConfiguration`	キャッシュホストからキャッシュ管理の構成を削除します。このコマンドはサーバー上でローカルに動作します。
`Remove-CacheCluster`	`Remove-AFCacheClusterConfiguration`	既存のクラスター構成を削除します。
`Remove-CacheHost`	`Remove-AFCacheHost`	現在キャッシュクラスターのメンバーになっていないキャッシュホストの構成を削除します。このコマンドはサーバー上でローカルに動作します。
`Set-CacheConfigurationLog`	`Set-AFCacheConfigurationLogging`	構成コマンドのログ記録に使用するカスタムログファイルの場所を設定します。既定では、ログは Temp フォルダーに作成されます。
`Set-CacheConnectionString`	`Set-AFCacheTemporaryConnectionString`	一時的に使用する接続文字列を保持します。その後、Get-CacheConnectionString でこの文字列を取得できます。このコマンドはキャッシュクラスター構成ストアで使用されている接続文字列を変更しないことに注意してください。ヒントこのコマンドは、. このコマンドを使用することが必要な既知のユーザーシナリオはありません。
`Test-CacheClusterConnection`	`Test-AFCacheClusterConnection`	キャッシュクラスター構成ストアへの接続をテストします。
`Unregister-CacheHost`	`Unregister-AFCacheHost`	キャッシュクラスター構成ストアからキャッシュホストエントリを削除します。現在のホストが登録解除された場合、HostName パラメーターは必要ありません。この場合、Provider および ConnectionString パラメーターも省略可能です。ただし、現在のキャッシュホストが構成されており、Remove-CacheHost コマンドがキャッシュホストで呼び出されていないことが前提です。警告 `Stop-CacheHost` を呼び出して、キャッシュホストを登録解除する前にキャッシュホストを停止する必要があります。この操作が行われていないと、サービスがクラッシュする可能性があります。

次の方法で共有

Windows PowerShell によるキャッシュ構成 (AppFabric 1.1 キャッシュ)

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

構成コマンド

関連項目

概念

その他のリソース