Set-SPExcelServiceApplication

構文

ExistingTargetApplicationParameterSet

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnattendedAccountApplicationId <String>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

NewTargetApplicationParameterSet

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UnattendedServiceAccount <PSCredential>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

説明

例

例 1

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10

例 2

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

パラメーター

-AssignmentCollection

適用対象: SharePoint Server 2010、SharePoint Server 2013

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

パラメーターのプロパティ

パラメーター セット

-CachingOfUnusedFilesEnable

適用対象: SharePoint Server 2010、SharePoint Server 2013

Excel Services Application で使用されなくなったファイルをキャッシュに保存して再利用できるように指定します。 このパラメーターをコマンドで指定しない場合は、既定で true になります。

パラメーターのプロパティ

パラメーター セット

-Confirm

適用対象: SharePoint Server 2010、SharePoint Server 2013

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

パラメーターのプロパティ

パラメーター セット

-CrossDomainAccessAllowed

適用対象: SharePoint Server 2010、SharePoint Server 2013

他の HTTP ドメインに置かれている Web パーツまたは Web ページから、信頼できるブックとデータ接続ファイルを要求し、表示できるように指定します。

パラメーターのプロパティ

パラメーター セット

-EncryptedUserConnectionRequired

適用対象: SharePoint Server 2010、SharePoint Server 2013

エンド ユーザーとアプリケーションを実行しているサーバーの間で暗号化Excel Services使用する必要があります。 この設定の範囲は、論理サーバーです。 既定値は None です。

この型は、None または Connection のいずれかであることが必要です。

パラメーターのプロパティ

パラメーター セット

-ExternalDataConnectionLifetime

適用対象: SharePoint Server 2010、SharePoint Server 2013

接続プール内で外部データ接続を開いた状態に保持できる最大時間 (秒) を指定します。

有効な値は次のとおりです。

-1 リサイクルしない

1 から 2073600 1 秒から 24 日間アクティブなままになります。

既定値は 1800 です。

パラメーターのプロパティ

パラメーター セット

-FileAccessMethod

適用対象: SharePoint Server 2010、SharePoint Server 2013

Excel Services Application でファイルを取得する場合に使用する認証方法を指定します。 UseFileAccessAccount を指定した場合、Excel Services Application を実行しているサービス アカウントの資格情報がすべてのブックで必ず使用されます。 UseImpersonation は、アプリケーションExcel Services要求を行うユーザーとしてブック ファイルを取得することを指定します。 既定値は UseImpersonation です。

この型は、UseImpersonation または UseFileAccessAccount のいずれかであることが必要です。

パラメーターのプロパティ

パラメーター セット

-Identity

適用対象: SharePoint Server 2010、SharePoint Server 2013

更新する SPExcelServiceApplication オブジェクトを指定します。

型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID である必要があります。ファーム内のExcel Services Application Web サービス アプリケーション (MyExcelService1 など) の有効な名前、または有効な SPExcelServiceApplication オブジェクトのインスタンス。

パラメーターのプロパティ

パラメーター セット

-LoadBalancingScheme

適用対象: SharePoint Server 2010、SharePoint Server 2013

Excel Services Application Web サービス アプリケーションが異なるバックエンド Excel Services アプリケーション コンピューターに要求を送信するために使用する負荷分散スキーマを指定します。 既定値は WorkbookURL です。

この型は、RoundRobin、Local、WorkbookURL のいずれかであることが必要です。

パラメーターのプロパティ

パラメーター セット

-MemoryCacheThreshold

適用対象: SharePoint Server 2010、SharePoint Server 2013

アクティブでないオブジェクトに割り当てることができるプライベート バイトの最大サイズの割合を指定します。 メモリ キャッシュのしきい値を超えると、キャッシュに残っている現在使用されていないオブジェクトは解放されます。 この値を 0 に設定すると、アクティブでないオブジェクトのキャッシュが無効になります。 既定値は 90 です。

この型は、0～95 の範囲の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-PrivateBytesMax

適用対象: SharePoint Server 2010、SharePoint Server 2013

アプリケーションで使用される最大プライベート バイト (メガバイト単位) Excel Services指定します。 -1 を設定した場合、プライベート バイトの最大サイズは、既定でコンピューター上の物理メモリの 50% に設定されます。 有効な値は、-1 (無制限) または任意の正の整数です。 既定値は -1 です。

この型は、-1 または任意の正の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-SessionsPerUserMax

適用対象: SharePoint Server 2010、SharePoint Server 2013

ユーザーに許可されるセッションの最大数を指定します。 ユーザーがこの最大数に達した場合、新しいセッションが開始されると、最も古いセッションが削除されます。 有効な値は、-1 (無制限) または任意の正の整数です。 既定値は 25 です。

この型は、-1 または任意の正の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-SiteCollectionAnonymousSessionsMax

適用対象: SharePoint Server 2010、SharePoint Server 2013

1 つのサイト コレクションで許可される匿名セッションの最大数を指定します。 この値を 0 に指定すると、匿名セッションが完全に禁止されます。 有効な値は、-1 (無制限)、0 (設定の無効化)、または任意の正の整数です。 既定値は 25 です。

この型は、-1、0、または任意の正の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-TerminateProcessOnAccessViolation

適用対象: SharePoint Server 2010、SharePoint Server 2013

プロセスでアクセス違反が発生したときに、Excel Services Application を終了します。

パラメーターのプロパティ

パラメーター セット

-ThrottleAccessViolationsPerSiteCollection

適用対象: SharePoint Server 2010、SharePoint Server 2013

ブックがアプリケーションでアクセス違反エラーを引き起こす場合、そのブック Excel Servicesのサイト コレクションから送信されたすべてのファイルが、指定した期間 (秒単位) の読み込みをブロックすることを指定します。 このサイト コレクションのファイルに対する既存のセッションは影響を受けません。 有効な値は、0 (設定を無効にする)、および 1 ～ 2,073,600 秒 (24 日) の範囲内の値です。 既定値は 0 です。

この型は、0～2,073,600 の範囲の整数値であることが必要です。

パラメーターのプロパティ

パラメーター セット

-UnattendedAccountApplicationId

適用対象: SharePoint Server 2010、SharePoint Server 2013

UnattendedAccountSecureServiceAppName パラメーターで指定したセキュリティで保護されたストレージ サービスから無人サービス アカウントの資格情報を検索するためのアプリケーション ID を指定します。 このパラメーターを設定した場合、特定のエラーが発生すると、セキュリティで保護されたストレージ サービスへの接続が行われます。 有効な値は、最大 256 文字の英数字です。 既定値は空の文字列です。

この型は、有効な英数字の文字列 (UnattendedServiceAccountID など) であることが必要です。

無人アカウントは、すべてのブックでデータの更新に使用できる単一のアカウントです。 ブックの接続で認証に None を指定する場合や Windows 資格情報以外の資格情報を使用してデータを更新する場合は、無人アカウントが必要になります。

パラメーターのプロパティ

パラメーター セット

-UnattendedServiceAccount

適用対象: SharePoint Server 2013

無人サービス アカウントは、すべてのブックがデータの更新に使用できる 1 つのアカウントです。 このアカウントは、ブック接続で Windows 資格情報を使用せずに "無人サービス アカウントを使用する" を指定した場合にデータを更新するために必要です。

パラメーターのプロパティ

パラメーター セット

-UnusedObjectAgeMax

適用対象: SharePoint Server 2010、SharePoint Server 2013

セッションで現在使用していないオブジェクトをメモリ キャッシュで保持する最大時間 (分) を指定します。 有効な値は、-1 (最大時間を設定しない) および 1 ～ 34,560 分 (24 日) です。 既定値は -1 です。

この型は、-1 または 1 ～ 34,560 の範囲の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-UseEffectiveUserName

適用対象: SharePoint Server 2013

UseEffectiveUserName プロパティは、ユーザーが Analysis Services データに安全にアクセスできるようにするための Windows 委任の代替手段です。

この設定は、"認証されたユーザーのアカウントを使用する" という認証設定を使用した Analysis Services ブック接続に基づく外部データ接続にのみ影響します。

パラメーターのプロパティ

パラメーター セット

-WhatIf

適用対象: SharePoint Server 2010、SharePoint Server 2013

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

パラメーターのプロパティ

パラメーター セット

-WorkbookCache

適用対象: SharePoint Server 2010、SharePoint Server 2013

アプリケーションで使用されるブックの格納に使用するキャッシュのローカル ファイル システムの場所Excel Services指定します。

値を指定しない場合の既定値は、システムの一時ディレクトリのサブディレクトリです。

この型は、次のいずれかの形式の有効なパスであることが必要です。

-- C:\folder_name -- \\server_name\folder_name

パラメーターのプロパティ

パラメーター セット

-WorkbookCacheSizeMax

適用対象: SharePoint Server 2010、SharePoint Server 2013

個々のセッションの最大サイズ (MB 単位) を指定します。 既定値は 0 です。

この型は、任意の正の整数であることが必要です。

パラメーターのプロパティ

パラメーター セット

-WorkbookModelUsageTracker

適用対象: SharePoint Server 2013

{{WorkbookModelUsageTracker の説明の入力}}

パラメーターのプロパティ

パラメーター セット

CommonParameters