分散キャッシュサービスを管理する (SharePoint Server)

[アーティクル]
03/08/2023

適用対象: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

SharePoint Server で、分散キャッシュサービスに関する管理および運用タスクを実行するには、管理者は特定の規則的な手順を実行する必要があります。この記事では、分散キャッシュサービスに関するいくつかの管理および運用タスクを実行する方法について説明します。

重要

この記事に示されている手順に従わない場合、分散キャッシュサービスは機能しない状態または回復不可能な状態になる可能性があります。極端なシナリオでは、サーバーファームの再構築が必要になる場合があります。 SharePoint Server 2019、2016、および 2013 の場合、分散キャッシュは前提条件として Windows Server AppFabric に依存します。 [ AppFabric キャッシュサービス] を [ コントロールパネル] の [ 管理ツール] の [ サービス] ウィンドウから管理しないでください。 [ スタート] メニューで、[ AppFabric for Windows Server] という名前のフォルダーに含まれるアプリケーションを使用しないでください。 SharePoint 分散キャッシュを使用した AppFabric のセキュリティの追加はサポートされていません。 SharePoint Server サブスクリプションエディションの場合、別の Windows Server AppFabric 製品は非推奨となり、テクノロジは SharePoint 内に内部的に統合されました。

重要

$ 記号が含まれているサービスアカウント名を使用しないでください。

分散キャッシュサービスの PowerShell コマンドレットの一覧

SharePoint Server PowerShell では、次の PowerShell コマンドレットを使用できるようになりました。

SharePoint Server Subscription Edition コマンドレット	APP Fabric コマンドレット	説明
New-SPCache	New-Cache	クラスターの実行時に、新しい名前付きキャッシュを作成します。
Get-SPCache	Get-Cache	クラスター内のすべてのキャッシュとリージョン、および各リージョンが存在するキャッシュホストを一覧表示します。パラメーターがないと、すべてのクラスターキャッシュとそのホストリージョンの詳細が返されます。 Hostname パラメーターと CachePort パラメーターが指定されている場合、キャッシュとリージョンの詳細は、指定されたホストに対してのみ返されます。
Get-SPCacheStatistics	Get-CacheStatistics	キャッシュまたはキャッシュホストの統計を返します。
Get-SPCacheHost	Get-CacheHost	キャッシュクラスターのメンバーであるすべてのキャッシュホストサービスを一覧表示します。
Start-SPCacheCluster	Start-CacheCluster	クラスター内のすべてのキャッシュホストでキャッシュサービスを開始します。最初にリードホストが開始されます。
Stop-SPCacheCluster	Stop-CacheCluster	クラスター内のすべてのキャッシュホストでキャッシュサービスを停止します。
Import-SPCacheClusterConfig	Import-CacheClusterConfig	XML ファイルからキャッシュクラスター構成の詳細をインポートします。
Export-SPCacheClusterConfig	Export-CacheClusterConfig	キャッシュクラスター構成を XML ファイルにエクスポートします。
Get-SPCacheClusterHealth	Get-CacheClusterHealth	キャッシュクラスター内のすべての名前付きキャッシュの正常性統計を返します。これには、まだ割り当てられていないものも含まれます。
Use-SPCacheCluster	Use-CacheCluster	PowerShell セッションのコンテキストを特定のキャッシュクラスターに設定します。
Get-SPCacheHostConfig	Get-CacheHostConfig	キャッシュクラスター内のキャッシュホスト構成情報を取得します。
Get-SPCacheClusterInfo	Get-CacheClusterInfo	ファーム内のキャッシュクラスター情報を取得します。
Set-SPCacheClusterSecurity	Set-CacheClusterSecurity	キャッシュクラスターのセキュリティプロパティを設定します。

分散キャッシュサービスを開始および終了する

メンテナンスタスクおよび運用タスクを実行する管理者は、分散キャッシュサービスの開始および停止が必要になる場合があります。そのタスクのいくつかを以下に示します。

インストール時にサーバーファームの既定の構成を変更する。インストール時にすべての SharePoint サーバーで分散キャッシュサービスが開始されます。管理者は、ファーム内の一部のサーバーで分散キャッシュサービスを停止しなければならない場合があります。
サーバーを更新する。SharePoint Server ファームに分散キャッシュサーバーが 1 つのみ存在する。

キャッシュを停止すると、結果的に、部分的なデータの損失が発生します。フィードキャッシュは分散キャッシュサービスに依存します。タグとドキュメントアクティビティはフィードキャッシュにのみ保存されます。タグとドキュメントアクティビティはコンテンツデータベースに保持されません。分散キャッシュサービスが停止すると、タグとドキュメントアクティビティは失われます。分散キャッシュサービスが開始されると、フィードキャッシュの再作成のタイマージョブが実行されるときに、再作成が実行されます。タグとドキュメントアクティビティを維持する 1 つの方法は、この記事の後半の「PowerShell スクリプトを使用して分散キャッシュサービスの正常なシャットダウンを実行する」で説明されている方法を使用することです。分散キャッシュサービスの正常なシャットダウンの方法を使用すると、分散キャッシュサービスが停止する前にすべてのキャッシュデータが 1 つのサーバーから別のサーバーに移動します。

注:

キャッシュホストがキャッシュクラスターの一部になっている場合は、ここで説明されている方法で分散キャッシュサービスを開始または停止しないでください。代わりに、この記事の後半の「分散キャッシュクラスターでサーバーを追加または削除する」を参照してください。

サーバーの全体管理を使用して、分散キャッシュサービスを開始および停止するには

サーバーの全体管理で、[ アプリケーション構成の管理] をクリックします。
[ サービスアプリケーション] で、[ サーバーのサービスの管理] をクリックします。
[ サーバーのサービス] ページで、[ Distributed Cache] サービスを見つけます。
分散キャッシュサービスが開始されており、サービスを停止する場合は、[ 処理] の下の [ 停止] をクリックします。分散キャッシュサービスが停止しており、サービスを開始する場合は、[ 処理] の下の [ 開始] をクリックします。

SharePoint 管理シェルを使用して分散キャッシュサービスを開始するには

SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。

SharePoint Server Subscription Edition
SharePoint Server 2019、2016、および 2013

$instanceName ="SPDistributedCacheService Name=SPCache"
$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}
$serviceInstance.Provision()

$instanceName ="SPDistributedCacheService Name=AppFabricCachingService"
$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}
$serviceInstance.Provision()

SharePoint 管理シェルを使用して分散キャッシュサービスを停止するには

SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。

SharePoint Server Subscription Edition
SharePoint Server 2019、2016、および 2013

$instanceName ="SPDistributedCacheService Name=SPCache"
$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}
$serviceInstance.Unprovision()

$instanceName ="SPDistributedCacheService Name=AppFabricCachingService"
$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}
$serviceInstance.Unprovision()

分散キャッシュサービスのメモリ割り当てを変更する

SharePoint Server をインストールすると、サーバーの総物理メモリの 10 パーセントが分散キャッシュサービスに割り当てられます。分散キャッシュサービスは、メモリ割り当ての半分をデータストレージ用に使用し (キャッシュサイズとも呼ばれる)、メモリ割り当てのもう半分はメモリ管理オーバーヘッド用に使用されます。キャッシュされたデータが増大すると、分散キャッシュサービスは、割り当てられた 10 パーセントのメモリをすべて使用します。

以下のような状況では、分散キャッシュサービスのメモリ割り当てを増やす必要があります。

サーバーに物理メモリを追加する場合。分散キャッシュサービスでは 10% のメモリ割り当てが自動的に再計算されないため、サーバー上の物理メモリの合計を増やす場合は、分散キャッシュサービスのメモリ割り当てを手動で増やす必要があります。
サーバーファームに専用の分散キャッシュサーバーがある場合。以下の方法を使用して、分散キャッシュサービスに割り当てることができるメモリの量を計算します。
1. サーバーの総物理メモリを確認します。この例では、サーバーで使用可能な総物理メモリとして 16 GB を使用します。
2. キャッシュホストで実行される他のプロセスおよびサービス用に 2 GB のメモリを確保します。たとえば、16 GB - 2 GB = 14 GB になります。この残りのメモリが分散キャッシュサービスに割り当てられます。
3. 残りのメモリの半分を MB に変換します。たとえば、14 GB/2 = 7 GB、つまり 7168 MB になります。これが、分散キャッシュサービスのキャッシュサイズです。
4. 以下の手順を使用して、メモリ割り当てを適切に更新します。

分散キャッシュのメモリ割り当てを変更する

以下の手順を使用して、分散キャッシュサービスのキャッシュサイズのメモリ割り当てを再構成します。

(省略可能) サーバーにおける分散キャッシュサービスの現在のメモリ割り当てを確認するには、SharePoint 管理シェルコマンドプロンプトで次のコマンドを実行します。
- SharePoint Server Subscription Edition
- SharePoint Server 2019、2016、および 2013
```
Use-SPCacheCluster
Get-SPCacheHostConfig -HostName $Env:ComputerName
```
ここで、
- ComputerName は、SharePoint 管理シェルコマンドレットを実行するサーバーのコンピューター名です。
```
Use-CacheCluster
Get-AFCacheHostConfiguration -ComputerName $Env:ComputerName -CachePort "22233"
```
ここで、
- ComputerName は、SharePoint 管理シェルコマンドレットを実行するサーバーのコンピューター名です。
すべてのキャッシュホストで分散キャッシュサービスを停止します。分散キャッシュサービスを停止するには、全体管理の [ サーバーのサービス] で、ファームのすべてのキャッシュホスト上の分散キャッシュサービスを [ 停止] します。
分散キャッシュサービスのキャッシュサイズを再構成するには、SharePoint 管理シェルコマンドプロンプトで、いずれかのキャッシュホストについて次のコマンドを 1 回だけ実行します。
```
Update-SPDistributedCacheSize -CacheSizeInMB CacheSize
```
ここで、
- CacheSize は、キャッシュサイズのメモリ割り当て (MB) です。上の例で、16 GB の総メモリを持つサーバーのキャッシュサイズは、7168 MB に計算されました。
すべてのキャッシュホストで分散キャッシュサービスを再起動します。分散キャッシュサービスを再起動するには、全体管理の [サーバーのサービス] で、ファーム内のすべてのキャッシュホストの分散キャッシュサービスを [開始] します。

分散キャッシュクラスターでサーバーを追加または削除する

管理者は、キャッシュクラスターにサーバーを追加または削除したり、キャッシュクラスターからサーバーを削除したり、サーバーで操作タスクやメンテナンスタスクを実行したり、キャッシュクラスターにサーバーを再参加または追加したりできます。サーバーを削除すると、分散キャッシュサービスが停止し、サーバーから登録解除されます。分散キャッシュサービスの登録を解除すると、管理者はサーバーの全体管理の [ サーバー上のサービス ] ページに分散キャッシュサービスが表示されません。同様に、サーバーが追加されると、分散キャッシュサービスが登録され、サーバー上で開始されます。分散キャッシュサービスを登録すると、管理者はサーバーの全体管理の [ サーバー上のサービス ] ページに分散キャッシュサービスが表示されます。

以下の手順を使用して、サーバーをキャッシュクラスターに追加したりキャッシュクラスターから削除したりします。以下の SharePoint 管理シェルコマンドレットを、追加または削除されるサーバーで実行します。

注:

以下の手順を実行する前に、ファイアウォールが ICMP (ICMPv4) の受信トラフィックを許可していることを確認してください。詳細については、「ファイアウォール構成の考慮事項」を参照してください。

サーバーをキャッシュクラスターに追加し、SharePoint 管理シェルを使用して分散キャッシュサービスを開始する

SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。

Add-SPDistributedCacheServiceInstance

SharePoint 管理シェルを使用してキャッシュクラスターからサーバーを削除する

SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。

Remove-SPDistributedCacheServiceInstance

重要

この手順を実行すると、キャッシュサービスが停止し、保持されていないキャッシュデータが失われます。キャッシュされたデータを保持する場合は、次のセクションで記載されている正常なシャットダウン手順を使用します。

PowerShell スクリプトを使用して分散キャッシュサービスの正常なシャットダウンを実行する

SharePoint Server ファームでは、1 つ以上のキャッシュホストが分散キャッシュサービスを実行するときにキャッシュクラスターが存在します。 SharePoint Server ファームには 1 つのキャッシュが存在し、キャッシュはキャッシュクラスターにまたがる。管理者は、サーバーに更新プログラムを適用する際に、キャッシュされたコンテンツを別のキャッシュホストに移動する必要がある場合があります。キャッシュされたコンテンツの移動に関連するデータ損失を防ぐには、次の手順で PowerShell スクリプトを使用してサーバーを正常にシャットダウンする必要があります。正常なシャットダウン手順を実行すると、正常なシャットダウン手順が実行されるキャッシュホストからすべてのキャッシュデータがファーム内の別のキャッシュホストに転送されます。転送処理の実行には、キャッシュに存在するアイテムの数に応じて 15 分以上かかります。

PowerShell スクリプトを使用して分散キャッシュの正常なシャットダウンを実行するには

キャッシュされたコンテンツを別のキャッシュホストに移動するため、次の PowerShell スクリプトを使用して分散キャッシュサーバーの正常なシャットダウンを実行します。シャットダウンする正しいノードを指定し、必要に応じてスクリプトを変更して、組織の正しいパラメーターに名前を付けます。

注:

正常なシャットダウンを実行するために PowerShell スクリプトを以下の手順で使用する場合は、キャッシュクラスターからキャッシュホストを削除する必要はありません。

注:

SharePoint Server サブスクリプションエディションでは、正常なシャットダウンのためにスクリプト ps 実行しないでください。代わりに、 stop-SPDistributedCacheServiceInstance を -Graceful パラメーターで実行して実行します。

次の最小要件を満たしていることを確認します:
- 「Add-SPShellAdmin」を参照してください。
- 「about_Execution_Policies」をお読みください。

以下の変数の宣言をコピーし、メモ帳などのテキストエディターに貼り付けます。組織に固有のパラメーター値を設定します。ファイルを保存し、 GracefulShutdown.ps1という名前を付けます。

注:

別のファイル名を使用できますが、拡張子が .ps1の ANSI でエンコードされたテキストファイルとしてファイルを保存する必要があります。

## Settings you may want to change for your scenario ##
$startTime = Get-Date
$currentTime = $startTime
$elapsedTime = $currentTime - $startTime
$timeOut = 900
Use-CacheCluster
try
{
    Write-Host "Shutting down distributed cache host."
 $hostInfo = Stop-CacheHost -Graceful -CachePort 22233 -ComputerName sp2016App.contoso.com
 while($elapsedTime.TotalSeconds -le $timeOut-and $hostInfo.Status -ne 'Down')
 {
     Write-Host "Host Status : [$($hostInfo.Status)]"
     Start-Sleep(5)
     $currentTime = Get-Date
     $elapsedTime = $currentTime - $startTime
     $hostInfo = Get-CacheHost -HostName SP2016app.contoso.com -CachePort 22233
 }
 Write-Host "Stopping distributed cache host was successful. Updating Service status in SharePoint."
 Stop-SPDistributedCacheServiceInstance
 Write-Host "To start service, please use Central Administration site."
}
catch [System.Exception]
{
 Write-Host "Unable to stop cache host within 15 minutes." 
}

ここで sp2016App.contoso.com は、使用する分散キャッシュサーバーのコンピュータードメイン名です。

SharePoint 管理シェルを開きます。
ファイルを保存したディレクトリに移動します。
PowerShell コマンドプロンプトで、次のコマンドを入力します。
```
./GracefulShutdown.ps1
```
PowerShell スクリプトと .ps1 ファイルの詳細については、「 Windows PowerShell スクリプトの実行」を参照してください。

サービスアカウントを変更する

サーバーファームが最初に構成されると、サーバーファームアカウントが AppFabric Caching サービス/SharePoint Caching Service のサービスアカウントとして設定されます。分散キャッシュサービスは、AppFabric キャッシュサービス/SharePoint キャッシュサービスによって異なります。 AppFabric Caching サービス/SharePoint Caching Service のサービスアカウントをマネージドアカウントに変更するには、

サービスを選択して、サービスアカウントを変更します。

SharePoint Server Subscription Edition
SharePoint Server 2019、2016、および 2013

管理アカウントを作成します。
SharePoint キャッシュサービスで、マネージドアカウントをサービスアカウントとして設定します。 SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。
```
$farm = Get-SPFarm
$cacheService = $farm.Services | where {$_.Name -eq "SPCache"}
$accnt = Get-SPManagedAccount -Identity domain_name\user_name
$cacheService.ProcessIdentity.CurrentIdentityType = "SpecificUser"
$cacheService.ProcessIdentity.ManagedAccount = $accnt
$cacheService.ProcessIdentity.Update() 
$cacheService.ProcessIdentity.Deploy()
```
ここで、Domain_name\user_nameは、SharePoint マネージドアカウントのドメイン名とユーザー名です。

管理アカウントを作成します。

管理アカウントを AppFabric キャッシュサービスのサービスアカウントとして設定します。 SharePoint 管理シェルコマンドプロンプトで、次のコマンドを実行します。

$farm = Get-SPFarm
$cacheService = $farm.Services | where {$_.Name -eq "AppFabricCachingService"}
$accnt = Get-SPManagedAccount -Identity domain_name\user_name
$cacheService.ProcessIdentity.CurrentIdentityType = "SpecificUser"
$cacheService.ProcessIdentity.ManagedAccount = $accnt
$cacheService.ProcessIdentity.Update() 
$cacheService.ProcessIdentity.Deploy()

ここで、Domain_name\user_nameは、SharePoint マネージドアカウントのドメイン名とユーザー名です。

PowerShell スクリプトを使用して分散キャッシュサービスを微調整する

監視

分散キャッシュサーバーのパフォーマンスカウンターを監視して、キャッシュのパフォーマンスの問題について理解を深めることができます。一般的に問題のトラブルシューティングに役立つカウンターには、次のようなものがあります。

%cpu がキャッシュサービスによって使用されます。
キャッシュサービスによって GC に費やされた %time。
キャッシュミスの総数/秒 - ここでの値が大きいと、キャッシュからデータをフェッチできないため、アプリケーションのパフォーマンスが低下する可能性があることを示す可能性があります。これには、キャッシュからのアイテムの削除や期限切れなどが考えられます。
合計オブジェクト数 - キャッシュ内の項目の数を示します。オブジェクト数が大幅に減少すると、削除または有効期限が発生している可能性があります。
クライアントの総要求数/秒 - このカウンターは、アプリケーションからキャッシュサーバーで生成されている負荷の量を把握するのに役立ちます。ここでの値が低いということは、通常、キャッシュサーバーの外部 (アプリケーションやネットワークなど) の外部にある種のボトルネックを意味するため、キャッシュサーバーに負荷がほとんどかっています。
削除されたオブジェクトの合計数 - キャッシュサーバーが常に項目を削除してキャッシュ内の新しいオブジェクト用のスペースを作る場合は、通常、アプリケーションのデータセットを保持するためにキャッシュサーバーにさらに多くのメモリが必要であることを示します。
失敗例外の合計/秒と再試行の合計例外数/秒。

MaxConnectionsToServer の分散キャッシュサービス設定は、多くの場合、ホストコンピューターで使用されている CPU 数に基づいて調整されます。たとえば、複数のコアを使用し、 MaxConnectionsToServer 設定を同じ数の CPU に設定すると、多くの場合、コンピューターはメモリを使用しすぎてフリーズします。 DistributedLogonTokenCache と DistributedViewStateCache の設定値を調整する場合にも同様の問題が生じます。既定の設定は 20 ミリ秒ですが、多くの場合、20 ミリ秒の設定でトークンキャッシュが発生しない場合は例外が見つかります。次の PowerShell スクリプトを使用して、SharePoint Server 2016 および SharePoint Server 2013 の最大接続とタイムアウトの設定を変更します。

PowerShell スクリプトを使用して分散キャッシュサービスを微調整するには

次の最小要件を満たしていることを確認します。
- 「Add-SPShellAdmin」をご覧ください。
- 「about_Execution_Policies」をお読みください。

以下の変数の宣言をコピーし、メモ帳などのテキストエディターに貼り付けます。組織に固有のパラメーター値を設定します。ファイルを保存し、 MaxConnections.ps1という名前を付けます。

注:

別のファイル名を使用できますが、拡張子が .ps1の ANSI でエンコードされたテキストファイルとしてファイルを保存する必要があります。

SharePoint Server サブスクリプションエディションと SharePoint Server 2019 PowerShell スクリプト

Add-PSSnapin Microsoft.Sharepoint.Powershell -ea 0

#DistributedLogonTokenCache
$DLTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache
$DLTC.MaxConnectionsToServer = 1
$DLTC.requestTimeout = "3000"
$DLTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache $DLTC

#DistributedViewStateCache
$DVSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache
$DVSC.MaxConnectionsToServer = 1
$DVSC.requestTimeout = "3000"
$DVSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache $DVSC

#DistributedAccessCache
$DAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache
$DAC.MaxConnectionsToServer = 1
$DAC.requestTimeout = "3000"
$DAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache $DAC

#DistributedActivityFeedCache
$DAF = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache
$DAF.MaxConnectionsToServer = 1
$DAF.requestTimeout = "3000"
$DAF.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache $DAF

#DistributedActivityFeedLMTCache
$DAFC = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache
$DAFC.MaxConnectionsToServer = 1
$DAFC.requestTimeout = "3000"
$DAFC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache $DAFC

#DistributedBouncerCache
$DBC = Get-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache
$DBC.MaxConnectionsToServer = 1
$DBC.requestTimeout = "3000"
$DBC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache $DBC

#DistributedDefaultCache
$DDC = Get-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache
$DDC.MaxConnectionsToServer = 1
$DDC.requestTimeout = "3000"
$DDC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache $DDC

#DistributedSearchCache
$DSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache
$DSC.MaxConnectionsToServer = 1
$DSC.requestTimeout = "3000"
$DSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache $DSC

#DistributedSecurityTrimmingCache
$DTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache
$DTC.MaxConnectionsToServer = 1
$DTC.requestTimeout = "3000"
$DTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache $DTC

#DistributedServerToAppServerAccessTokenCache
$DSTAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache
$DSTAC.MaxConnectionsToServer = 1
$DSTAC.requestTimeout = "3000"
$DSTAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache $DSTAC

#DistributedFileLockThrottlerCache
$DFLTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedFileLockThrottlerCache
$DFLTC.MaxConnectionsToServer = 1
$DFLTC.requestTimeout = "3000"
$DFLTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedFileLockThrottlerCache $DFLTC

#DistributedSharedWithUserCache
$DSWUC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSharedWithUserCache
$DSWUC.MaxConnectionsToServer = 1
$DSWUC.requestTimeout = "3000"
$DSWUC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSharedWithUserCache $DSWUC

#DistributedUnifiedGroupsCache
$DUGC = Get-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedGroupsCache
$DUGC.MaxConnectionsToServer = 1
$DUGC.requestTimeout = "3000"
$DUGC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedGroupsCache $DUGC 

#DistributedResourceTallyCache
$DRTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedResourceTallyCache
$DRTC.MaxConnectionsToServer = 1
$DRTC.requestTimeout = "3000"
$DRTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedResourceTallyCache $DRTC

#DistributedHealthScoreCache
$DHSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedHealthScoreCache
$DHSC.MaxConnectionsToServer = 1
$DHSC.requestTimeout = "3000"
$DHSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedHealthScoreCache $DHSC  

#DistributedDbLevelFailoverCache
$DDBFC = Get-SPDistributedCacheClientSetting -ContainerType DistributedDbLevelFailoverCache
$DDBFC.MaxConnectionsToServer = 1
$DDBFC.requestTimeout = "3000"
$DDBFC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedDbLevelFailoverCache $DDBFC

#DistributedEdgeHeaderCache
$DEHC = Get-SPDistributedCacheClientSetting -ContainerType DistributedEdgeHeaderCache
$DEHC.MaxConnectionsToServer = 1
$DEHC.requestTimeout = "3000"
$DEHC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedEdgeHeaderCache $DEHC

#DistributedFileStorePerformanceTraceCache
$DFSPTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedFileStorePerformanceTraceCache
$DFSPTC.MaxConnectionsToServer = 1
$DFSPTC.requestTimeout = "3000"
$DFSPTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedFileStorePerformanceTraceCache $DFSPTC

#DistributedSPAbsBlobCache
$DSPABSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSPAbsBlobCache
$DSPABSC.MaxConnectionsToServer = 1
$DSPABSC.requestTimeout = "3000"
$DSPABSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSPAbsBlobCache $DSPABSC

#DistributedSPCertificateValidatorCache
$DSPCVC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSPCertificateValidatorCache
$DSPCVC.MaxConnectionsToServer = 1
$DSPCVC.requestTimeout = "3000"
$DSPCVC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSPCertificateValidatorCache $DSPCVC

#DistributedSPOAuthTokenCache
$DSPOATC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSPOAuthTokenCache
$DSPOATC.MaxConnectionsToServer = 1
$DSPOATC.requestTimeout = "3000"
$DSPOATC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSPOAuthTokenCache $DSPOATC

#DistributedStopgapCache
$DSGC = Get-SPDistributedCacheClientSetting -ContainerType DistributedStopgapCache
$DSGC.MaxConnectionsToServer = 1
$DSGC.requestTimeout = "3000"
$DSGC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedStopgapCache $DSGC

#DistributedUnifiedAppsCache
$DUAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedAppsCache
$DUAC.MaxConnectionsToServer = 1
$DUAC.requestTimeout = "3000"
$DUAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedAppsCache $DUAC

#DistributedUnifiedAuditCache
$DUAuC = Get-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedAuditCache
$DUAuC.MaxConnectionsToServer = 1
$DUAuC.requestTimeout = "3000"
$DUAuC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedAuditCache $DUAuC

SharePoint Server 2016 PowerShell スクリプト

Add-PSSnapin Microsoft.Sharepoint.Powershell -ea 0

#DistributedLogonTokenCache
$DLTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache
$DLTC.MaxConnectionsToServer = 1
$DLTC.requestTimeout = "3000"
$DLTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache $DLTC

#DistributedViewStateCache
$DVSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache
$DVSC.MaxConnectionsToServer = 1
$DVSC.requestTimeout = "3000"
$DVSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache $DVSC

#DistributedAccessCache
$DAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache
$DAC.MaxConnectionsToServer = 1
$DAC.requestTimeout = "3000"
$DAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache $DAC

#DistributedActivityFeedCache
$DAF = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache
$DAF.MaxConnectionsToServer = 1
$DAF.requestTimeout = "3000"
$DAF.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache $DAF

#DistributedActivityFeedLMTCache
$DAFC = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache
$DAFC.MaxConnectionsToServer = 1
$DAFC.requestTimeout = "3000"
$DAFC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache $DAFC

#DistributedBouncerCache
$DBC = Get-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache
$DBC.MaxConnectionsToServer = 1
$DBC.requestTimeout = "3000"
$DBC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache $DBC

#DistributedDefaultCache
$DDC = Get-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache
$DDC.MaxConnectionsToServer = 1
$DDC.requestTimeout = "3000"
$DDC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache $DDC

#DistributedSearchCache
$DSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache
$DSC.MaxConnectionsToServer = 1
$DSC.requestTimeout = "3000"
$DSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache $DSC

#DistributedSecurityTrimmingCache
$DTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache
$DTC.MaxConnectionsToServer = 1
$DTC.requestTimeout = "3000"
$DTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache $DTC

#DistributedServerToAppServerAccessTokenCache
$DSTAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache
$DSTAC.MaxConnectionsToServer = 1
$DSTAC.requestTimeout = "3000"
$DSTAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache $DSTAC

#DistributedFileLockThrottlerCache
$DFLTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedFileLockThrottlerCache
$DFLTC.MaxConnectionsToServer = 1
$DFLTC.requestTimeout = "3000"
$DFLTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedFileLockThrottlerCache $DFLTC

#DistributedSharedWithUserCache
$DSWUC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSharedWithUserCache
$DSWUC.MaxConnectionsToServer = 1
$DSWUC.requestTimeout = "3000"
$DSWUC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSharedWithUserCache $DSWUC

#DistributedUnifiedGroupsCache
$DUGC = Get-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedGroupsCache
$DUGC.MaxConnectionsToServer = 1
$DUGC.requestTimeout = "3000"
$DUGC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedUnifiedGroupsCache $DUGC 

#DistributedResourceTallyCache
$DRTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedResourceTallyCache
$DRTC.MaxConnectionsToServer = 1
$DRTC.requestTimeout = "3000"
$DRTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedResourceTallyCache $DRTC

#DistributedHealthScoreCache
$DHSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedHealthScoreCache
$DHSC.MaxConnectionsToServer = 1
$DHSC.requestTimeout = "3000"
$DHSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedHealthScoreCache $DHSC

SharePoint Server 2013 PowerShell スクリプト

Add-PSSnapin Microsoft.Sharepoint.Powershell -ea 0

#DistributedLogonTokenCache
$DLTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache
$DLTC.MaxConnectionsToServer = 1
$DLTC.requestTimeout = "3000"
$DLTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedLogonTokenCache $DLTC

#DistributedViewStateCache
$DVSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache
$DVSC.MaxConnectionsToServer = 1
$DVSC.requestTimeout = "3000"
$DVSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedViewStateCache $DVSC

#DistributedAccessCache
$DAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache
$DAC.MaxConnectionsToServer = 1
$DAC.requestTimeout = "3000"
$DAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedAccessCache $DAC

#DistributedActivityFeedCache
$DAF = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache
$DAF.MaxConnectionsToServer = 1
$DAF.requestTimeout = "3000"
$DAF.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedCache $DAF

#DistributedActivityFeedLMTCache
$DAFC = Get-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache
$DAFC.MaxConnectionsToServer = 1
$DAFC.requestTimeout = "3000"
$DAFC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedActivityFeedLMTCache $DAFC

#DistributedBouncerCache
$DBC = Get-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache
$DBC.MaxConnectionsToServer = 1
$DBC.requestTimeout = "3000"
$DBC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedBouncerCache $DBC

#DistributedDefaultCache
$DDC = Get-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache
$DDC.MaxConnectionsToServer = 1
$DDC.requestTimeout = "3000"
$DDC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedDefaultCache $DDC

#DistributedSearchCache
$DSC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache
$DSC.MaxConnectionsToServer = 1
$DSC.requestTimeout = "3000"
$DSC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSearchCache $DSC

#DistributedSecurityTrimmingCache
$DTC = Get-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache
$DTC.MaxConnectionsToServer = 1
$DTC.requestTimeout = "3000"
$DTC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedSecurityTrimmingCache $DTC

#DistributedServerToAppServerAccessTokenCache
$DSTAC = Get-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache
$DSTAC.MaxConnectionsToServer = 1
$DSTAC.requestTimeout = "3000"
$DSTAC.channelOpenTimeOut = "3000"
Set-SPDistributedCacheClientSetting -ContainerType DistributedServerToAppServerAccessTokenCache $DSTAC

SharePoint 管理シェルを開きます。
ファイルを保存したディレクトリに移動します。
PowerShell コマンドプロンプトで、次のコマンドを入力します。
```
./MaxConnections.ps1
```

詳細については、「アプリケーション構成設定 (Windows Server AppFabric キャッシュ)」を参照してください。 Windows PowerShell スクリプトと .ps1 ファイルの詳細については、「 Windows PowerShell スクリプトの実行」を参照してください。

キャッシュホストを修復する

インストール、構成、または保守作業の際に、分散キャッシュサービスが機能しない状態に陥る可能性があります。分散キャッシュサービスが機能していないことは、サーバーの全体管理の正常性ルールによって、または分散キャッシュに依存する SharePoint Server の機能をユーザーが使用したときに明らかになります。たとえば、ユーザーの個人用サイト上のニュースフィードからエラーが報告されるようになります。また、管理者が分散キャッシュサービスを管理するために SharePoint 管理シェルコマンドレットを実行した場合に "cacheHostInfo is NULL " というエラーメッセージを受け取る可能性もあります。

キャッシュホストは、2 つの手順で修復します。

機能しなくなった分散キャッシュホストで、次の手順を実行して分散キャッシュホストを復旧します。

SharePoint 管理シェルコマンドプロンプトで、Remove-SPDistributedCacheServiceInstance コマンドレットを実行します。
SharePoint 管理シェルコマンドプロンプトで、Add-SPDistributedCacheServiceInstance コマンドレットを実行します。

注:

手順 1 が失敗した場合は、次に示す手順を使用して分散キャッシュサービスを手動で削除します。
- SharePoint 管理シェルコマンドプロンプトで、次の構文を入力します。
  - SharePoint Server Subscription Edition
  - SharePoint Server 2019、2016、および 2013
```
$instanceName ="SPDistributedCacheService Name=SPCache"

$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}

If($serviceInstance -ne $null)
{
$serviceInstance.Delete()
}
```
```
$instanceName ="SPDistributedCacheService Name=AppFabricCachingService"

$serviceInstance = Get-SPServiceInstance | ? {($_.service.tostring()) -eq $instanceName -and ($_.server.name) -eq $env:computername}

If($serviceInstance -ne $null)
{
$serviceInstance.Delete()
}
```
- 手動で分散キャッシュサービスを削除したら、手順 2 を再実行します。

次の方法で共有

分散キャッシュサービスを管理する (SharePoint Server)

分散キャッシュサービスの PowerShell コマンドレットの一覧

分散キャッシュサービスを開始および終了する

サーバーの全体管理を使用して、分散キャッシュサービスを開始および停止するには

SharePoint 管理シェルを使用して分散キャッシュサービスを開始するには

SharePoint 管理シェルを使用して分散キャッシュサービスを停止するには

分散キャッシュサービスのメモリ割り当てを変更する

分散キャッシュのメモリ割り当てを変更する

分散キャッシュクラスターでサーバーを追加または削除する

サーバーをキャッシュクラスターに追加し、SharePoint 管理シェルを使用して分散キャッシュサービスを開始する

SharePoint 管理シェルを使用してキャッシュクラスターからサーバーを削除する

PowerShell スクリプトを使用して分散キャッシュサービスの正常なシャットダウンを実行する

PowerShell スクリプトを使用して分散キャッシュの正常なシャットダウンを実行するには

サービスアカウントを変更する

PowerShell スクリプトを使用して分散キャッシュサービスを微調整する

キャッシュホストを修復する

関連項目

概念

その他のリソース

次の方法で共有

分散キャッシュ サービスを管理する (SharePoint Server)

分散キャッシュ サービスの PowerShell コマンドレットの一覧

分散キャッシュ サービスを開始および終了する

サーバーの全体管理を使用して、分散キャッシュ サービスを開始および停止するには

SharePoint 管理シェルを使用して分散キャッシュ サービスを開始するには

SharePoint 管理シェルを使用して分散キャッシュ サービスを停止するには

分散キャッシュ サービスのメモリ割り当てを変更する

分散キャッシュのメモリ割り当てを変更する

分散キャッシュ クラスターでサーバーを追加または削除する

サーバーをキャッシュ クラスターに追加し、SharePoint 管理シェルを使用して分散キャッシュ サービスを開始する

SharePoint 管理シェルを使用してキャッシュ クラスターからサーバーを削除する

PowerShell スクリプトを使用して分散キャッシュ サービスの正常なシャットダウンを実行する

PowerShell スクリプトを使用して分散キャッシュの正常なシャットダウンを実行するには

サービス アカウントを変更する

PowerShell スクリプトを使用して分散キャッシュ サービスを微調整する

キャッシュ ホストを修復する

関連項目

概念

その他のリソース

分散キャッシュサービスを管理する (SharePoint Server)

分散キャッシュサービスの PowerShell コマンドレットの一覧

分散キャッシュサービスを開始および終了する

サーバーの全体管理を使用して、分散キャッシュサービスを開始および停止するには

SharePoint 管理シェルを使用して分散キャッシュサービスを開始するには

SharePoint 管理シェルを使用して分散キャッシュサービスを停止するには

分散キャッシュサービスのメモリ割り当てを変更する

分散キャッシュクラスターでサーバーを追加または削除する

サーバーをキャッシュクラスターに追加し、SharePoint 管理シェルを使用して分散キャッシュサービスを開始する

SharePoint 管理シェルを使用してキャッシュクラスターからサーバーを削除する

PowerShell スクリプトを使用して分散キャッシュサービスの正常なシャットダウンを実行する

サービスアカウントを変更する

PowerShell スクリプトを使用して分散キャッシュサービスを微調整する

キャッシュホストを修復する