Set-SPExcelServiceApplication

  • リファレンス
モジュール:
SharePointServer
適用対象:
SharePoint Server 2010, SharePoint Server 2013

Excel Services アプリケーションのグローバル プロパティを設定します。

構文

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>]
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>]

説明

コマンドレットはSet-ExcelServiceApplication、Excel Services アプリケーションのグローバル ランタイム プロパティを変更します。 このコマンドレットを使用して行われるプロパティの変更は、指定された Excel Services Application Web サービス アプリケーションのインスタンスを実行しているファーム内のすべてのマシンに影響します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例

-------------- 例 1 --------------

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

次の使用例は、Excel Services アプリケーションを実行するバックエンド アプリケーション サーバーで、各ユーザーが一度に 10 個以下のセッションを開くことができるよう、Excel Services アプリケーションを設定します。

-------------- 例 2 --------------

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

次の使用例は、コンピューター上のメモリのプライベート バイトの最大数を -1 に設定します。これは、Excel Servicesアプリケーションが使用可能なメモリ リソースの 50% を消費することを示しています。

パラメーター

-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

-EncryptedUserConnectionRequired

エンド ユーザーとアプリケーションを実行しているサーバーの間で暗号化Excel Services使用する必要があります。 この設定の範囲は、論理サーバーです。 既定値は 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要求を行うユーザーとしてブック ファイルを取得することを指定します。 既定値は 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

-Identity

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

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

Type:SPExcelServiceApplicationPipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-LoadBalancingScheme

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

-PrivateBytesMax

アプリケーションで使用される最大プライベート バイト (メガバイト単位) Excel Services指定します。 -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発生した場合、そのブックのサイト コレクションから送信されたすべてのファイルが、指定した期間 (秒単位) の読み込みをブロックすることを指定します。 このサイト コレクションのファイルに対する既存のセッションは影響を受けません。 有効な値は、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

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 プロパティは、ユーザーが Analysis Services データに安全にアクセスできるようにするための Windows 委任の代替手段です。

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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指定します。

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

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

-- 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 2013