New-SPExcelServiceApplication

構文

ExistingTargetApplicationParameterSet

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-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

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-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

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

例 2

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

パラメーター

-ApplicationPool

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

新しい Excel Services Application 用の Web サービスを実行するための既存の IIS アプリケーション プールを指定します。

この型は、有効な SPIisWebServiceApplicationPool オブジェクトです。

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

パラメーター セット

-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 ページから、信頼できるブックとデータ接続ファイルを要求し、表示できるように指定します。

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

パラメーター セット

-Default

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

このサービス アプリケーションのプロキシをファームの既定のプロキシ グループに追加することを指定します。

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

パラメーター セット

-EncryptedUserConnectionRequired

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

エンド ユーザーと Excel Services Application サーバーとの間で暗号化を使用する必要があります。 この設定の範囲は、論理サーバーです。 既定値は 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 Application がブック ファイルを取得します。 既定値は UseImpersonation です。

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

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

パラメーター セット

-LoadBalancingScheme

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

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

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

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

パラメーター セット

-MemoryCacheThreshold

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

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

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

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

パラメーター セット

-Name

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

新しい Excel Services Application Web サービス アプリケーションのフレンドリ名を指定します。 使用する Excel Services Application Web サービス アプリケーション名は、このファーム内で一意である必要があります。 名前は最大 128 文字にすることができます。 既定値は Service_numofapplications+1 です。

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

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

パラメーター セット

-PrivateBytesMax

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

Excel Services Application で使用するプライベート バイトの最大サイズを MB 単位で指定します。 -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 Application のアクセス違反エラーが発生した場合に、このブックのサイト コレクションから派生するすべてのファイルを読み込まないようにする期間を秒単位で指定します。 このサイト コレクションのファイルに対する既存のセッションは影響を受けません。 有効な値は、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 2010、SharePoint Server 2013

{{UnattendedServiceAccount の説明の入力}}

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

パラメーター セット

-UnusedObjectAgeMax

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

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

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

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

パラメーター セット

-UseEffectiveUserName

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

{{UseEffectiveUserName の説明の入力}}

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

パラメーター セット

-WhatIf

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

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

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

パラメーター セット

-WorkbookCache

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

Excel Services Application で使用するブックを格納するための、ローカルのファイル システム上のキャッシュの場所を指定します。

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

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

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

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

パラメーター セット

-WorkbookCacheSizeMax

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

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

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

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

パラメーター セット

-WorkbookModelUsageTracker

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

{{WorkbookModelUsageTracker の説明の入力}}

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

パラメーター セット

CommonParameters