New-SPExcelServiceApplication
Excel Services Application の新しいインスタンスを作成します。
構文
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>] 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>] 説明
New-SPExcelServiceApplication コマンドレットは、新しい設定で新しい Excel Services Application Web サービス アプリケーションを作成します。
新しい Excel Services Application Web サービス アプリケーションを作成した後は、Set-SPExcelServiceApplication コマンドレットを使用して、新しいアプリケーションのグローバルな設定を変更できます。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 1 ------------------
New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"この例では、Excel Services Application の新しいインスタンスを MyExcelService という表示名で作成します。
------------------ 例 2 ------------------
New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5この例では、Excel Services Applicationの新しいインスタンスを My Excel Service という表示名で作成し、Excel Services Applicationを実行するバックエンド アプリケーション サーバー コンピューターごとに各ユーザーに許可するセッション数を 5 つに限定します。
パラメーター
-ApplicationPool
新しい Excel Services Application 用の Web サービスを実行するための既存の IIS アプリケーション プールを指定します。
この型は、有効な SPIisWebServiceApplicationPool オブジェクトです。
| Type: | SPIisWebServiceApplicationPoolPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-CachingOfUnusedFilesEnable
Excel Services Application で使用されなくなったファイルをキャッシュに保存して再利用できるように指定します。 このパラメーターをコマンドで指定しない場合は、既定で true になります。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Confirm
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-CrossDomainAccessAllowed
他の HTTP ドメインに置かれている Web パーツまたは Web ページから、信頼できるブックとデータ接続ファイルを要求し、表示できるように指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Default
このサービス アプリケーションのプロキシをファームの既定のプロキシ グループに追加することを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-EncryptedUserConnectionRequired
エンド ユーザーと Excel Services Application サーバーとの間で暗号化を使用する必要があります。 この設定の範囲は、論理サーバーです。 既定値は None です。
この型は、None または Connection のいずれかであることが必要です。
| Type: | EncryptedConnectionMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataConnectionLifetime
接続プール内で外部データ接続を開いた状態に保持できる最大時間 (秒) を指定します。 有効な値は次のとおりです。
-1 リサイクルしない
1 から 2073600 1 秒から 24 日間アクティブなままになります。
既定値は 1800 です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-FileAccessMethod
Excel Services Application でファイルを取得する場合に使用する認証方法を指定します。 UseFileAccessAccount を指定した場合、Excel Services Application を実行しているサービス アカウントの資格情報がすべてのブックで必ず使用されます。 UseImpersonation を指定した場合、要求を行ったユーザーとして Excel Services Application がブック ファイルを取得します。 既定値は UseImpersonation です。
この型は、UseImpersonation または UseFileAccessAccount のいずれかであることが必要です。
| Type: | FileAccessMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LoadBalancingScheme
Excel Calculation Services を実行している異なるバックエンド コンピューターに Excel Services Application Web サービス アプリケーションで要求を送信するための負荷分散スキーマを指定します。 既定値は WorkbookURL です。
この型は、RoundRobin、Local、WorkbookURL のいずれかであることが必要です。
| Type: | LoadBalancingScheme |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-MemoryCacheThreshold
アクティブでないオブジェクトに割り当てることができるプライベート バイトの最大サイズの割合を指定します。 メモリ キャッシュのしきい値を超えると、キャッシュに残っている現在使用されていないオブジェクトは解放されます。 この値を 0 に設定すると、アクティブでないオブジェクトのキャッシュが無効になります。 既定値は 90 です。
この型は、0～95 の範囲の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Name
新しい Excel Services Application Web サービス アプリケーションのフレンドリ名を指定します。 使用する Excel Services Application Web サービス アプリケーション名は、このファーム内で一意である必要があります。 名前は最大 128 文字にすることができます。 既定値は Service_numofapplications+1 です。
この型は、有効な文字列 (MyExcelServiceApp1 など) であることが必要です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PrivateBytesMax
Excel Services Application で使用するプライベート バイトの最大サイズを MB 単位で指定します。 -1 を設定した場合、プライベート バイトの最大サイズは、既定でコンピューター上の物理メモリの 50% に設定されます。 有効な値は、-1 (無制限) または任意の正の整数です。 既定値は -1 です。
この型は、-1 または任意の正の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionsPerUserMax
ユーザーに許可されるセッションの最大数を指定します。 ユーザーがこの最大数に達した場合、新しいセッションが開始されると、最も古いセッションが削除されます。 有効な値は、-1 (無制限) または任意の正の整数です。 既定値は 25 です。
この型は、-1 または任意の正の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SiteCollectionAnonymousSessionsMax
1 つのサイト コレクションで許可される匿名セッションの最大数を指定します。 この値を 0 に指定すると、匿名セッションが完全に禁止されます。 有効な値は、-1 (無制限)、0 (設定の無効化)、または任意の正の整数です。 既定値は 25 です。
この型は、-1、0、または任意の正の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-TerminateProcessOnAccessViolation
プロセスでアクセス違反が発生したときに、Excel Services Application を終了します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ThrottleAccessViolationsPerSiteCollection
ブックが原因で Excel Services Application のアクセス違反エラーが発生した場合に、このブックのサイト コレクションから派生するすべてのファイルを読み込まないようにする期間を秒単位で指定します。 このサイト コレクションのファイルに対する既存のセッションは影響を受けません。 有効な値は、0 (設定を無効にする)、および 1 ～ 2,073,600 秒 (24 日) の範囲内の値です。 既定値は 0 です。
この型は、0～2,073,600 の範囲の整数値であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnattendedAccountApplicationId
UnattendedAccountSecureServiceAppName で指定したセキュリティで保護されたストア サービスから無人サービス アカウントの資格情報を検索するためのアプリケーション ID を指定します。 このパラメーターを設定した場合、特定のエラーが発生すると、セキュリティで保護されたストア サービスへの接続が行われます。 有効な値は、最大 256 文字の英数字です。 既定値は空の文字列です。
この型は、有効な英数字の文字列 (UnattendedServiceAccountID など) であることが必要です。
無人アカウントは、すべてのブックでデータの更新に使用できる単一のアカウントです。 ブックの接続で認証に None を指定する場合や Windows 資格情報以外の資格情報を使用してデータを更新する場合は、無人アカウントが必要になります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnattendedServiceAccount
{{UnattendedServiceAccount の説明の入力}}
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnusedObjectAgeMax
セッションで現在使用していないオブジェクトをメモリ キャッシュで保持する最大時間 (分) を指定します。 有効な値は、-1 (最大時間を設定しない) および 1 ～ 34,560 分 (24 日) です。 既定値は -1 です。
この型は、-1 または 1 ～ 34,560 の範囲の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UseEffectiveUserName
{{UseEffectiveUserName の説明の入力}}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookCache
Excel Services Application で使用するブックを格納するための、ローカルのファイル システム上のキャッシュの場所を指定します。
値を指定しない場合の既定値は、システムの一時ディレクトリのサブディレクトリです。
この型は、次のいずれかの形式の有効なパスであることが必要です。
-- C:\folder_name -- \\server_name\folder_name
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookCacheSizeMax
個々のセッションの最大サイズ (MB 単位) を指定します。 既定値は 0 です。
この型は、任意の正の整数であることが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookModelUsageTracker
{{WorkbookModelUsageTracker の説明の入力}}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |