Set-SPExcelFileLocation
Excel Services アプリケーションの信頼できるファイル保存場所のプロパティを設定します。
構文
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 アプリケーションは、ブックの読み込み元の信頼されたファイルの場所によって定義されるプロパティを常に適用します。
信頼されたファイルの場所で使用されるプロパティは、ブックのファイル パスと信頼されたファイルの場所の Address パラメーターの比較によって決まります。
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
ファイルを開いたときにデータの自動更新操作が失敗した場合に、Excel Services アプリケーション ファイルの読み込みが自動的に失敗することを指定します。 読み込みは、次の条件が満たされた場合にのみ失敗します。
-- ユーザーには、Excel Services アプリケーション ファイルに対する読み取り専用アクセス許可があります。 -- ブック ファイルには、Excel ファイルを開いたときに自動的に更新されるデータ接続があります。
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 |
-Address
System.String
アプリケーションがブックを読み込める Web フォルダーまたはファイル ディレクトリExcel Services指定します。
型は、フォーム https://myPortal/myTeamの有効な URL、またはフォームの有効な UNC パスである必要があります。\\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 |
-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 |
-AutomaticVolatileFunctionCacheLifetime
揮発性関数の計算値が自動計算のためにキャッシュされる最大時間 (秒単位) を指定します。 有効な値は次のとおりです。
-1、ブックの読み込み時に 1 回計算する
0、常に計算
1 ~ 2073600、キャッシュ 1 秒から 24 日
この型は、-1、0、または 1 ~ 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 |
-ChartAndImageSizeMax
開くことができるグラフまたは画像の最大サイズ (MB 単位) を指定します。 既定値は 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 |
-ChartRenderDurationMax
1 つのグラフのレンダリングに費やされた最大時間 (秒単位)。
有効な値: -1 (制限なし)。1 から 2073600 (24 日間)。
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 |
-ConcurrentDataRequestsPerSessionMax
1 つのセッションで同時に許容される外部データ要求の最大数を指定します。 1 つのセッションでこれよりも多くの要求を発行する必要がある場合は、超過分の要求をキューに格納する必要があります。 この設定の範囲は、論理サーバーです。 既定値は 5 です。
この型は、正の整数であることが必要です。
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 |
-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 |
-DefaultWorkbookCalcMode
ブックの計算モードを指定します。 [ファイル] 設定を除くすべての設定は、ブックの設定をオーバーライドします。 このパラメーターを変更すると、ConfigDB プロパティ キャッシュが更新されたときに、Excel Services アプリケーション上のすべての新しいセッションに適用されます。 既定の設定は File です。
この型は、File、Manual、Auto、AutoDataTables のいずれかであることが必要です。
Type: | DefaultWorkbookCalcMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
新しいファイルの場所に関するわかりやすい説明を指定します。
この型は有効な文字列である必要があります。たとえば、「月間売上報告書のファイルの場所」などのように指定します。
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 |
-DisplayGranularExtDataErrors
この場所のファイルで発生した外部データ エラーの詳しいエラー メッセージを表示します。
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 |
-ExcelServiceApplication
SPExcelFileLocation リスト オブジェクトを含むアプリケーション Web サービス アプリケーションExcel Servicesを指定します。
型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID である必要があります。ファーム内のExcel Services Application Web サービス アプリケーション (MyExcelService1 など) の有効な名前、または有効な SPExcelServiceApplication オブジェクトのインスタンス。
Type: | SPExcelServiceApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataAllowed
ブックに許可される外部データ アクセスの種類を指定します。[なし] は、データ更新が無効になっていることを指定します。 Dcl は、信頼できるデータ接続ライブラリ内の接続ファイルを使用するときだけデータを更新することを指定します。 DclandEmbedded は、データ接続ライブラリを使用できる (必須ではない) ことを指定します。 この設定の範囲は、信頼できる場所です。
既定値は None です。
型は、None、Dcl、または DclAndEmbedded のいずれかである必要があります。
Type: | AllowExternalData |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
更新する FileLocation オブジェクトを指定します。 名前は、ファイルの場所の一覧で一意である必要があります。
型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID である必要があります。ファイルの場所を示す有効な文字列 。C https://myPortal/myTeam:\folder_name 形式のパスを識別する有効な文字列、または有効な SPExcelFileLocation オブジェクトのインスタンス。
Type: | SPExcelFileLocationPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
下位 URL、ディレクトリ、ライブラリが信頼されていることを示します。 たとえば、信頼できるファイルの場所が https://portalで、IncludeChildren が true の場合 https://portal/subSite 、アドレスで指定された URL の下のサブURL と同様に、信頼されます。
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 |
-LocationType
場所の種類。 LocationType は、アプリケーションExcel Servicesアドレスで指定された場所からファイルを取得する方法を示します。 既定値は SharePoint です。
この型は、SharePoint、UNC、HTTP のいずれかであることが必要です。
Type: | LocationType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
手動またはユーザーが開始した外部データ要求を再発行する前に、アプリケーションExcel Services待機する時間を秒単位で指定します。 この期間中は、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。
有効な値は次のとおりです。
-1 最初のクエリの後に更新しない
1 ~ 2073600 キャッシュ 1 秒から 24 日。
既定値は 300 です。
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 |
-NewWorkbookSessionTimeout
新しい未保存のブックのセッションが、ユーザー アクティビティなしでアプリケーションExcel Servicesアクティブな状態を維持する時間を秒単位で指定します。 既定値は 1800 です。 有効な値は次のとおりです。
-1、セッションが期限切れになることはありません
0、セッションは 1 つの要求の最後に期限切れになります
1 ~ 2073600、アクティブな状態は 1 秒から 24 日です。
この型は、-1、0、または 1 ~ 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 |
-PeriodicExtDataCacheLifetime
オープン時または定期的な (つまり自動) 外部データ要求を再発行する前に、アプリケーションExcel Services待機する時間を秒単位で指定します。 この期間中は、前の外部データ要求の結果が外部データ キャッシュから返される場合があります。 値 -1 は、最初のクエリの後に更新されないように指定します。
この型は、-1、0、または 1 ~ 2,073,600 の範囲の整数であることが必要です。
既定値は 300 です。
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 |
-RequestDurationMax
セッションの 1 つの要求の最大持続時間を秒単位で指定します。 この時間が経過すると、要求はタイムアウトになります。
この型は、-1 (無期限)、または 1 ~ 2,073,600 の範囲の整数であることが必要です。
既定値は 300 です。
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 |
-RESTExternalDataAllowed
Representational State Transfer (REST) アプリケーション プログラミング インターフェイス (API) からの要求で外部データ接続を更新することを許可するかどうかを指定します。
外部 DataAllowed パラメーターが None に設定されている場合、RESTExternalDataAllowed パラメーターは無効です。
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 |
-SessionTimeout
セッションがユーザー アクティビティなしでアプリケーションExcel Servicesアクティブな状態を維持する時間を秒単位で指定します。 既定値は 300 秒です。 既定値は 300 です。 有効な値は次のとおりです。
-1、セッションが期限切れになることはありません
0、セッションは 1 つの要求の最後に期限切れになります
1 ~ 2073600、アクティブな 1 秒から 24 日
この型は、-1、0、または 1 ~ 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 |
-ShortSessionTimeout
ユーザーがスプレッドシートで最初の操作を行うまでの制限時間を秒単位で指定します。 この時間が経過すると、ユーザーがアクティブでない場合、セッションは閉じられます。 値は SessionTimeout 未満であることが必要です。 ShortSessionTimeout 値が SessionTimeout 以上の場合、エラーが返されます。 既定値は 75 です。
この型は、-1 または 1 ~ 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 |
-UdfsAllowed
[アドレス] で指定された信頼されたファイルの場所から読み込まれたブックによって、ユーザー定義関数を呼び出すことができることを指定します。
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 |
-WarnOnDataRefresh
ユーザーがブックのデータを最初に更新したときに警告を表示するように指定します。 既定値は 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 |
-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 |
-WorkbookSizeMax
読み込み可能なブックの最大サイズ (MB 単位) を指定します。 既定値は 10 です。
この型は、1 ~ 2,000 の範囲の整数値であることが必要です。
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 |