New-SPExcelFileLocation

Excel Services アプリケーションに新しい信頼できる場所を追加します。

構文

New-SPExcelFileLocation
   -Address <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-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>]

説明

コマンドレットはNew-SPExcelFileLocation、Excel Services Application Web サービス アプリケーションの信頼できるファイルの場所の一覧に新しい場所を追加します。 Excel Services アプリケーションは、信頼されたファイルの場所に格納されているブックのみを読み込みます。 信頼できるファイルの場所のプロパティは、アプリケーションに読み込まれるときにブックを使用する方法Excel Services制御します。 Excel Services アプリケーションでは、ブックの読み込み元の信頼されたファイルの場所によって定義されたプロパティが常に適用されます。 信頼できるファイル保存場所で使用されるプロパティは、ブックのファイル パスと信頼できるファイル保存場所の Address パラメーターとを比較することによって決定されます。

最も長い一致文字列が優先されます。 たとえば、と が信頼できる場所であり、サブサイトからブックを読み込む場合https://portal/site/https://portal/site/subsite、アプリケーションはサブサイトの信頼できる場所のプロパティを使用します。これは、一致するアドレスが最も長いためです。

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

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

次の使用例は、MyExcelService という名前のExcel Services アプリケーション Web サービス アプリケーションにある信頼できるファイルの場所の一覧に、新しい信頼されたファイルの場所を追加します。

この例では、 で始まる任意の子またはサブフォルダーからブックを読み込むことができます https://myPortal/myTeam. この場所から読み込むすべてのブックのサイズは、50 MB 未満である必要があります。 ブックでは、ブック ファイルに埋め込まれた接続またはデータ接続ライブラリ内の接続を使用して、外部データを更新できます。 ブックによる外部データの更新の試行を警告するメッセージは表示されません。

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

次の使用例は、MyExcelService という名前のExcel Services アプリケーション Web サービス アプリケーション内にある信頼できるファイルの場所の一覧に、指定されたアドレスと説明を含む新しい信頼されたファイルの場所を追加します。

パラメーター

-AbortOnRefreshOnOpenFail

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

  • ユーザーには、ファイルに対する SharePoint 製品とテクノロジの読み取り専用アクセス許可があります。
  • ブック ファイルには、Excel Services アプリケーション ファイルを開いたときに自動的に更新されるデータ接続があります。
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

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

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

Type:String
Position:Named
Default value:None
Required:True
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 日。 既定の整数値は 300 です。

この型は、-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

{{Fill ChartRenderDurationMax Description}}

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

ブックの計算モードを指定します。 File 以外のすべての設定は、ブックの設定をオーバーライドします。 既定の設定は 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

ブックで許可される外部データ アクセスの種類を指定します。 None は、データ更新を無効にすることを指定します。 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

-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

場所の種類を指定します。 場所の種類は、アプリケーションExcel Servicesアドレスで指定された場所からファイルを取得する方法を示します。 既定の設定は SharePoint の種類です。 既定値は 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待機する時間を秒単位で指定します。 この待機時間中に、前の外部データ要求からの結果が外部データ キャッシュから返される場合があります。 既定値は 300 です。

有効な値は、次のいずれかです。

-1 初回のクエリ後は更新しません。 1 ~ 2,073,600 1 秒~ 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

-NewWorkbookSessionTimeout

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

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

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

1 から 2073600 1 秒から 24 日間アクティブなままになります。 既定値は 1800 です。

この型は、-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 を指定した場合、初回のクエリ後に更新は行われません。 既定値は 300 です。

この型は、-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

-RequestDurationMax

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

この型は、-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

-RESTExternalDataAllowed

Representational State Transfer (REST) アプリケーション プログラミング インターフェイス (API) からの要求で外部データ接続を更新することを許可するかどうかを指定します。 ExternalDataAllowed パラメーターを 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指定します。 有効な値は次のとおりです。

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

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

1 から 2073600 1 秒から 24 日間アクティブなままになります。 既定値は 300 です。

この型は、-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

Address で指定した信頼できるファイル保存場所から読み込んだブックでユーザー定義関数を呼び出せることを指定します。

既定値は False です。

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