Set-SPExcelFileLocation

構文

Default (既定)

Set-SPExcelFileLocation
    [-Identity] <SPExcelFileLocationPipeBind>
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AbortOnRefreshOnOpenFail]
    [-Address <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-AutomaticVolatileFunctionCacheLifetime <Int32>]
    [-ChartAndImageSizeMax <Int32>]
    [-ConcurrentDataRequestsPerSessionMax <Int32>]
    [-Confirm]
    [-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
    [-Description <String>]
    [-DisplayGranularExtDataErrors]
    [-ExternalDataAllowed <AllowExternalData>]
    [-IncludeChildren]
    [-LocationType <LocationType>]
    [-ManualExtDataCacheLifetime <Int32>]
    [-NewWorkbookSessionTimeout <Int32>]
    [-PeriodicExtDataCacheLifetime <Int32>]
    [-RequestDurationMax <Int32>]
    [-RESTExternalDataAllowed]
    [-SessionTimeout <Int32>]
    [-ShortSessionTimeout <Int32>]
    [-UdfsAllowed]
    [-WarnOnDataRefresh]
    [-WhatIf]
    [-WorkbookSizeMax <Int32>]
    [-ChartRenderDurationMax <Int32>]
    [<CommonParameters>]

説明

例

例 1

Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

例 2

Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."

パラメーター

-AbortOnRefreshOnOpenFail

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

ファイルを開いたときにデータの自動更新操作が失敗した場合に、Excel Services アプリケーション ファイルの読み込みが自動的に失敗することを指定します。 読み込みは、次の条件が満たされた場合にのみ失敗します。

-- ユーザーには、Excel Services アプリケーション ファイルに対する読み取り専用アクセス許可があります。 -- ブック ファイルには、Excel ファイルを開いたときに自動的に更新されるデータ接続があります。

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

パラメーター セット

-Address

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

System.String

アプリケーションがブックを読み込める Web フォルダーまたはファイル ディレクトリExcel Services指定します。

型は、フォーム https://myPortal/myTeamの有効な URL、またはフォームの有効な UNC パスである必要があります。\\server_name\folder_name

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

パラメーター セット

-AssignmentCollection

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

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

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

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

パラメーター セット

-AutomaticVolatileFunctionCacheLifetime

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

揮発性関数の計算値が自動計算のためにキャッシュされる最大時間 (秒単位) を指定します。 有効な値は次のとおりです。

-1、ブックの読み込み時に 1 回計算する

0、常に計算

1 ~ 2073600、キャッシュ 1 秒から 24 日

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

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

パラメーター セット

-ChartAndImageSizeMax

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

開くことができるグラフまたは画像の最大サイズ (MB 単位) を指定します。 既定値は 1 です。

この型は、0 よりも大きい有効な整数であることが必要です。

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

パラメーター セット

-ChartRenderDurationMax

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

1 つのグラフのレンダリングに費やされた最大時間 (秒単位)。

有効な値: -1 (制限なし)。1 から 2073600 (24 日間)。

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

パラメーター セット

-ConcurrentDataRequestsPerSessionMax

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

1 つのセッションで同時に許容される外部データ要求の最大数を指定します。 1 つのセッションでこれよりも多くの要求を発行する必要がある場合は、超過分の要求をキューに格納する必要があります。 この設定の範囲は、論理サーバーです。 既定値は 5 です。

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

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

パラメーター セット

-Confirm

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

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

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

パラメーター セット

-DefaultWorkbookCalcMode

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

ブックの計算モードを指定します。 [ファイル] 設定を除くすべての設定は、ブックの設定をオーバーライドします。 このパラメーターを変更すると、ConfigDB プロパティ キャッシュが更新されたときに、Excel Services アプリケーション上のすべての新しいセッションに適用されます。 既定の設定は File です。

この型は、File、Manual、Auto、AutoDataTables のいずれかであることが必要です。

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

パラメーター セット

-Description

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

新しいファイルの場所に関するわかりやすい説明を指定します。

この型は有効な文字列である必要があります。たとえば、「月間売上報告書のファイルの場所」などのように指定します。

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

パラメーター セット

-DisplayGranularExtDataErrors

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

この場所のファイルで発生した外部データ エラーの詳しいエラー メッセージを表示します。

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

パラメーター セット

-ExcelServiceApplication

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

SPExcelFileLocation リスト オブジェクトを含むアプリケーション Web サービス アプリケーションExcel Servicesを指定します。

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

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

パラメーター セット

-ExternalDataAllowed

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

ブックに許可される外部データ アクセスの種類を指定します。[なし] は、データ更新が無効になっていることを指定します。 Dcl は、信頼できるデータ接続ライブラリ内の接続ファイルを使用するときだけデータを更新することを指定します。 DclandEmbedded は、データ接続ライブラリを使用できる (必須ではない) ことを指定します。 この設定の範囲は、信頼できる場所です。

既定値は None です。

型は、None、Dcl、または DclAndEmbedded のいずれかである必要があります。

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

パラメーター セット

-Identity

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

更新する FileLocation オブジェクトを指定します。 名前は、ファイルの場所の一覧で一意である必要があります。

型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID である必要があります。ファイルの場所を識別する有効な文字列( https://myPortal/myTeam形式)、パスを識別する有効な文字列(C:\folder_name形式)、または有効な SPExcelFileLocation オブジェクトのインスタンス。

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

パラメーター セット

-IncludeChildren

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

下位 URL、ディレクトリ、ライブラリが信頼されていることを示します。 たとえば、信頼されたファイルの場所が https://portalされ、IncludeChildren が true の場合、アドレスで指定された URL の下にあるサブURL と同様に、 https://portal/subSite も信頼されます。

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

パラメーター セット

-LocationType

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

場所の種類。 LocationType は、アプリケーションExcel Servicesアドレスで指定された場所からファイルを取得する方法を示します。 既定値は SharePoint です。

この型は、SharePoint、UNC、HTTP のいずれかであることが必要です。

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

パラメーター セット

-ManualExtDataCacheLifetime

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

手動またはユーザーが開始した外部データ要求を再発行する前に、アプリケーションExcel Services待機する時間を秒単位で指定します。 この期間中は、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。

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

-1 最初のクエリの後に更新しない

1 ~ 2073600 キャッシュ 1 秒から 24 日。

既定値は 300 です。

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

パラメーター セット

-NewWorkbookSessionTimeout

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

新しい未保存のブックのセッションが、ユーザー アクティビティなしでアプリケーションExcel Servicesアクティブな状態を維持する時間を秒単位で指定します。 既定値は 1800 です。 有効な値は次のとおりです。

-1、セッションが期限切れになることはありません

0、セッションは 1 つの要求の最後に期限切れになります

1 ~ 2073600、アクティブな状態は 1 秒から 24 日です。

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

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

パラメーター セット

-PeriodicExtDataCacheLifetime

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

オープン時または定期的な (つまり自動) 外部データ要求を再発行する前に、アプリケーションExcel Services待機する時間を秒単位で指定します。 この期間中は、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。 値 -1 は、最初のクエリの後に更新されないように指定します。

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

既定値は 300 です。

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

パラメーター セット

-RequestDurationMax

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

セッションの 1 つの要求の最大持続時間を秒単位で指定します。 この時間が経過すると、要求はタイムアウトになります。

この型は、-1 (無期限)、または 1 ～ 2,073,600 の範囲の整数であることが必要です。

既定値は 300 です。

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

パラメーター セット

-RESTExternalDataAllowed

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

Representational State Transfer (REST) アプリケーション プログラミング インターフェイス (API) からの要求で外部データ接続を更新することを許可するかどうかを指定します。

外部 DataAllowed パラメーターが None に設定されている場合、RESTExternalDataAllowed パラメーターは無効です。

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

パラメーター セット

-SessionTimeout

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

セッションがユーザー アクティビティなしでアプリケーションExcel Servicesアクティブな状態を維持する時間を秒単位で指定します。 既定値は 300 秒です。 既定値は 300 です。 有効な値は次のとおりです。

-1、セッションが期限切れになることはありません

0、セッションは 1 つの要求の最後に期限切れになります

1 ~ 2073600、アクティブな 1 秒から 24 日

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

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

パラメーター セット

-ShortSessionTimeout

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

ユーザーがスプレッドシートで最初の操作を行うまでの制限時間を秒単位で指定します。 この時間が経過すると、ユーザーがアクティブでない場合、セッションは閉じられます。 値は SessionTimeout 未満であることが必要です。 ShortSessionTimeout 値が SessionTimeout 以上の場合、エラーが返されます。 既定値は 75 です。

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

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

パラメーター セット

-UdfsAllowed

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

[アドレス] で指定された信頼されたファイルの場所から読み込まれたブックによって、ユーザー定義関数を呼び出すことができることを指定します。

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

パラメーター セット

-WarnOnDataRefresh

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

ユーザーがブックのデータを最初に更新したときに警告を表示するように指定します。 既定値は True です。

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

パラメーター セット

-WhatIf

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

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

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

パラメーター セット

-WorkbookSizeMax

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

読み込み可能なブックの最大サイズ (MB 単位) を指定します。 既定値は 10 です。

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

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

パラメーター セット

CommonParameters