Set-SPExcelFileLocation
Excel Services アプリケーションの信頼できるファイル保存場所のプロパティを設定します。
構文
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>]
説明
Set-SPExcelFileLocation コマンドレットは、Excel Services アプリケーションがブックを読み込む場所のプロパティを設定します。
Excel Services アプリケーションは、信頼できるファイルの場所に格納されているブックのみを読み込みます。
信頼できるファイルの場所のプロパティによって、Excel Services アプリケーションに読み込まれるときにブックがどのように使用できるかが制御されます。
Excel Services アプリケーションは常に、ブックの読み込み元の信頼できるファイルの場所で定義されたプロパティを適用します。
信頼できるファイルの場所で使用されるプロパティは、ブックのファイル パスと信頼できるファイルの場所のアドレス パラメーターを比較することによって決定されます。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
例 1
Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl
この例では、My Excel Service という名前の Excel Services アプリケーション Web サービス アプリケーションの信頼されたファイルの場所をすべて取得します。このアプリケーションは、ブック ファイルからのデータ接続をロードし、場所でデータ接続をロードするにはデータ接続ライブラリを使用する必要があることを指定します。
例 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."
この例では、ファーム内のすべての Excel Services アプリケーション Web サービス アプリケーションの既定ファイルの場所の説明を変更します。
パラメーター
-AbortOnRefreshOnOpenFail
適用対象: SharePoint Server 2010、SharePoint Server 2013
Excel Services アプリケーション ファイルを開いたときに自動データ更新操作が失敗した場合、そのファイルの読み込みが自動的に失敗するように指定します。 読み込みは、次の条件が満たされた場合にのみ失敗します。
-- ユーザーには Excel Services アプリケーション ファイルに対する読み取り専用のアクセス許可があります。 -- ブック ファイルには、Excel ファイルを開くと自動的に更新されるデータ接続があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Address
適用対象: SharePoint Server 2010、SharePoint Server 2013
System.String
Excel Services アプリケーションがブックを読み込むことができる Web フォルダーまたはファイル ディレクトリを指定します。
種類は、有効な URL (形式 https://myPortal/myTeam) であるか、有効な UNC パス (形式 \\server_name\) である必要がありますfolder_name
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AssignmentCollection
適用対象: SharePoint Server 2010、SharePoint Server 2013
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AutomaticVolatileFunctionCacheLifetime
適用対象: SharePoint Server 2010、SharePoint Server 2013
揮発性関数の計算値が自動計算のためにキャッシュされる最大時間 (秒単位) を指定します。 有効な値は次のとおりです。
-1、ブックの読み込み時に 1 回計算する
0、常に計算
1 から 2073600、キャッシュ 1 秒から 24 日
この型は、-1、0、または 1 ～ 2,073,600 の範囲の整数値であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ChartAndImageSizeMax
適用対象: SharePoint Server 2010、SharePoint Server 2013
開くことができるグラフまたは画像の最大サイズ (MB 単位) を指定します。 既定値は 1 です。
この型は、0 よりも大きい有効な整数であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ChartRenderDurationMax
適用対象: SharePoint Server 2010、SharePoint Server 2013
1 つのグラフのレンダリングに費やされた最大時間 (秒)。
有効な値: -1 (制限なし);1 から 2073600 (24 日) まで。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ConcurrentDataRequestsPerSessionMax
適用対象: SharePoint Server 2010、SharePoint Server 2013
1 つのセッションで同時に許容される外部データ要求の最大数を指定します。 1 つのセッションでこれよりも多くの要求を発行する必要がある場合は、超過分の要求をキューに格納する必要があります。 この設定の範囲は、論理サーバーです。 既定値は 5 です。
この型は、正の整数であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: SharePoint Server 2010、SharePoint Server 2013
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultWorkbookCalcMode
適用対象: SharePoint Server 2010、SharePoint Server 2013
ブックの計算モードを指定します。 [ファイル] 設定を除くすべての設定は、ブックの設定よりも優先されます。 このパラメーターが変更されると、ConfigDB プロパティ キャッシュが更新されたときに、Excel Services アプリケーションのすべての新しいセッションに適用されます。 既定の設定は File です。
この型は、File、Manual、Auto、AutoDataTables のいずれかであることが必要です。
パラメーターのプロパティ
| 型: | DefaultWorkbookCalcMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
適用対象: SharePoint Server 2010、SharePoint Server 2013
新しいファイルの場所に関するわかりやすい説明を指定します。
この型は有効な文字列である必要があります。たとえば、「月間売上報告書のファイルの場所」などのように指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisplayGranularExtDataErrors
適用対象: SharePoint Server 2010、SharePoint Server 2013
この場所のファイルで発生した外部データ エラーの詳しいエラー メッセージを表示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExcelServiceApplication
適用対象: SharePoint Server 2010、SharePoint Server 2013
SPExcelFileLocation リスト オブジェクトが含まれる Excel Services アプリケーション Web サービス アプリケーションを指定します。
型は、12345678-90ab-cdef-1234-567890bcdefgh の形式の有効な GUID である必要があります。ファーム内の Excel Services Application Web サービス アプリケーションの有効な名前 (MyExcelService1 など)。または有効な SPExcelServiceApplication オブジェクトのインスタンス。
パラメーターのプロパティ
| 型: | SPExcelServiceApplicationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ExternalDataAllowed
適用対象: SharePoint Server 2010、SharePoint Server 2013
ブックに対して許可される外部データ アクセスの種類を指定します: なし データ更新を無効にすることを指定します。 Dcl は、信頼できるデータ接続ライブラリ内の接続ファイルを使用するときだけデータを更新することを指定します。 DclandEmbedded は、データ接続ライブラリを使用できる (必須ではない) ことを指定します。 この設定の範囲は、信頼できる場所です。
既定値は None です。
型は、None、Dcl、または DclAndEmbedded のいずれかである必要があります。
パラメーターのプロパティ
| 型: | AllowExternalData |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: SharePoint Server 2010、SharePoint Server 2013
更新する FileLocation オブジェクトを指定します。 名前は、ファイルの場所のリスト内で一意である必要があります。
型は、12345678-90ab-cdef-1234-567890bcdefgh の形式の有効な GUID である必要があります。ファイルの場所を識別する有効な文字列 (形式 https://myPortal/myTeam)、パスを識別する有効な文字列 (形式 C:\folder_name)。または有効な SPExcelFileLocation オブジェクトのインスタンス。
パラメーターのプロパティ
| 型: | SPExcelFileLocationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeChildren
適用対象: SharePoint Server 2010、SharePoint Server 2013
下位 URL、ディレクトリ、およびライブラリが信頼されていることを示します。 たとえば、信頼できるファイルの場所が https://portal で、IncludeChildren が true の場合、 https://portal/subSite も信頼され、アドレスに指定されている URL の下にあるサブ URL も信頼されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LocationType
適用対象: SharePoint Server 2010、SharePoint Server 2013
場所の種類。 LocationType は、Excel Services アプリケーションがアドレスで指定された場所からファイルを取得する方法を示します。 既定値は SharePoint です。
この型は、SharePoint、UNC、HTTP のいずれかであることが必要です。
パラメーターのプロパティ
| 型: | LocationType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ManualExtDataCacheLifetime
適用対象: SharePoint Server 2010、SharePoint Server 2013
Excel Services アプリケーションが手動で、またはユーザーが開始した外部データ要求を再発行する前に待機する時間 (秒) を指定します。 この期間中、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。
有効な値は次のとおりです。
-1 最初のクエリ後に更新しない
1 から 2073600 キャッシュ 1 秒から 24 日。
既定値は 300 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NewWorkbookSessionTimeout
適用対象: SharePoint Server 2010、SharePoint Server 2013
保存されていない新しいブックのセッションが、ユーザー アクティビティなしで Excel Services アプリケーションでアクティブなままになる時間 (秒) を指定します。 既定値は 1800 です。 有効な値は次のとおりです。
-1、セッションの有効期限はありません
0、セッションは 1 つの要求の終わりに期限切れになります
1 から 2073600、1 秒から 24 日間アクティブな状態を維持します。
この型は、-1、0、または 1 ～ 2,073,600 の範囲の整数であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PeriodicExtDataCacheLifetime
適用対象: SharePoint Server 2010、SharePoint Server 2013
Excel Services アプリケーションがオンオープンまたは定期的 (つまり自動) 外部データ要求を再発行する前に待機する時間を秒単位で指定します。 この期間中、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。 値 -1 は、最初のクエリの後に更新されないことを指定します。
この型は、-1、0、または 1 ～ 2,073,600 の範囲の整数であることが必要です。
既定値は 300 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequestDurationMax
適用対象: SharePoint Server 2010、SharePoint Server 2013
セッションの 1 つの要求の最大持続時間を秒単位で指定します。 この時間が経過すると、要求はタイムアウトします。
この型は、-1 (無期限)、または 1 ～ 2,073,600 の範囲の整数であることが必要です。
既定値は 300 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RESTExternalDataAllowed
適用対象: SharePoint Server 2010、SharePoint Server 2013
Representational State Transfer (REST) アプリケーション プログラミング インターフェイス (API) からの要求で外部データ接続を更新することを許可するかどうかを指定します。
External DataAllowed パラメーターが None に設定されている場合、RESTExternalDataAllowed パラメーターは効果がありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SessionTimeout
適用対象: SharePoint Server 2010、SharePoint Server 2013
セッションが Excel Services アプリケーションでアクティブ状態のままで、ユーザー アクティビティがない時間 (秒) を指定します。 既定値は 300 秒です。 既定値は 300 です。 有効な値は次のとおりです。
-1、セッションの有効期限はありません
0、セッションは 1 つの要求の終わりに期限切れになります
1 から 2073600、アクティブ状態を維持 1 秒から 24 日
この型は、-1、0、または 1 ～ 2,073,600 の範囲の整数であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ShortSessionTimeout
適用対象: SharePoint Server 2010、SharePoint Server 2013
ユーザーがスプレッドシートで最初の操作を行うまでの制限時間を秒単位で指定します。 この時間が経過すると、ユーザーがアクティブでない場合、セッションは閉じられます。 値は SessionTimeout 未満であることが必要です。 ShortSessionTimeout 値が SessionTimeout 以上の場合、エラーが返されます。 既定値は 75 です。
この型は、-1 または 1 ～ 2,073,600 の範囲の整数であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UdfsAllowed
適用対象: SharePoint Server 2010、SharePoint Server 2013
アドレスに指定されている信頼できるファイルの場所から読み込まれたブックによって、ユーザー定義関数を呼び出すことができることを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WarnOnDataRefresh
適用対象: SharePoint Server 2010、SharePoint Server 2013
ユーザーがブックのデータを最初に更新したときに警告を表示するように指定します。 既定値は True です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: SharePoint Server 2010、SharePoint Server 2013
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WorkbookSizeMax
適用対象: SharePoint Server 2010、SharePoint Server 2013
読み込み可能なブックの最大サイズ (MB 単位) を指定します。 既定値は 10 です。
この型は、1 ～ 2,000 の範囲の整数値であることが必要です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。