Set-SPExcelFileLocation

リファレンス

モジュール:: SharePointServer

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

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

Set-SPExcelFileLocation

構文

説明

例

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

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

パラメーター

-AbortOnRefreshOnOpenFail

-Address

-AssignmentCollection

-AutomaticVolatileFunctionCacheLifetime

-ChartAndImageSizeMax

-ChartRenderDurationMax

-ConcurrentDataRequestsPerSessionMax

-Confirm

-DefaultWorkbookCalcMode

-Description

-DisplayGranularExtDataErrors

-ExcelServiceApplication

-ExternalDataAllowed

-Identity

-IncludeChildren

-LocationType

-ManualExtDataCacheLifetime

-NewWorkbookSessionTimeout

-PeriodicExtDataCacheLifetime

-RequestDurationMax

-RESTExternalDataAllowed

-SessionTimeout

-ShortSessionTimeout

-UdfsAllowed

-WarnOnDataRefresh

-WhatIf

-WorkbookSizeMax

フィードバック

フィードバック

その他のリソース