New-SPExcelDataConnectionLibrary

Excel Services アプリケーションに新しいデータ接続ライブラリを追加します。

構文

New-SPExcelDataConnectionLibrary
   -Address <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Description <String>]
   [-WhatIf]
   [<CommonParameters>]

説明

このコマンドレットはNew-SPExcelDataConnectionLibrary、Excel Services Application Web サービス アプリケーションの信頼されたデータ接続ライブラリの一覧にデータ接続ライブラリを追加します。 Excel Services アプリケーションは、信頼されたデータ接続ライブラリの一覧にあるデータ接続ライブラリに格納されているデータ接続ファイルのみを読み込みます。 データ接続ライブラリには、アプリケーションと Excel クライアントが外部データ ソースに接続するために必要なすべてのリソースExcel Services含むデータ接続ファイルが含まれています。 データ接続ライブラリを使用すると、データ接続を再利用して共有できます。 データ接続は、ブック ファイルの情報を使用して読み込むことができます。ただし、データ接続ライブラリを使用してデータ接続を読み込むには、ブックとは別にデータ接続を管理できます。

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

------------------ 例 ------------------

$sa = Get-SPExcelServiceApplication
New-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL" -Description "This is the DCL where all the connections to the sales data are stored." -ExcelServiceApplication $sa

この例では、新しいデータ接続ライブラリ (DCL) を追加し、その説明を、MyExcelService という名前のExcel Services Application Web サービス アプリケーションにある信頼されたデータ接続ライブラリの一覧に設定します。

ブックでは、そのライブラリに格納されている接続ファイルを使用して、Excel Services Application Web サービス アプリケーションのデータを更新できます。

パラメーター

-Address

データ接続ライブラリのアドレスを指定します。 アドレスは、信頼できるデータ接続ライブラリの一覧内で一意であることが必要です。

この型は、http://<サーバー名>/<サイト名>/<ページ名> という形式の有効な URL であることが必要です。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Confirm

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Description

データ接続ライブラリのわかりやすい説明を指定します。

型は有効な文字列である必要があります。たとえば、これはカスタム OLEDB プロバイダーです。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExcelServiceApplication

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

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

Type:SPExcelServiceApplicationPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013