Install-SPDataConnectionFile
適用版本： SharePoint Server 2010
上次修改主題的時間： 2015-03-09
安裝提供的資料連線檔案。
Syntax
Install-SPDataConnectionFile [-Path] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Category <String>] [-Confirm [<SwitchParameter>]] [-Overwrite <SwitchParameter>] [-WebAccessible <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Install-SPDataConnectionFile cmdlet 可安裝所提供的資料連線檔案。若指定的資料連線檔案已存在，將會提示使用者取代現有的檔案。
此 cmdlet 不會建立新的檔案，而只會建立新的資料連線檔案物件。
如需 Windows PowerShell for SharePoint Server 2010 的權限及最新資訊，請參閱 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
Path |
必要 |
System.String |
指定資料連線儲存區中之檔案名稱的完整路徑。 此類型必須是有效資料連線檔案的名稱，例如 C:\foldername\myconnection.udcx。 |
AssignmentCollection |
選擇性 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Category |
選擇性 |
System.String |
為檔案設定任意的類別，以便於分組檔案。類別名稱最多可有 255 個字元。 此類型必須是有效的字串值，例如 Category1。 |
Confirm |
選擇性 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
Overwrite |
選擇性 |
System.Management.Automation.SwitchParameter |
覆寫現有的資料連線檔案。預設值為 False。 |
WebAccessible |
選擇性 |
System.Management.Automation.SwitchParameter |
指定可以利用 Web 服務進行存取的通用資料連線檔案。若為 False，只有 Microsoft Forms Server 2010 可以從內部擷取通用資料連線檔案。預設值為 False。 |
WhatIf |
選擇性 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
---------------範例--------------
Install-SPDataConnectionFile -Path .\folder\sample.udcx -Category "Install" -WebAccessible $true
".\folder\sample.udcx" | Install-SPDataConnectionFile -Category "Install" -Category "Category1" -Overwrite $true
此範例會將資料連線檔案上傳至指定的類別。
此 cmdlet 等同於 SharePoint 管理中心網站之 [管理資料連線檔案] 頁面上的 [上傳資料連線檔案] 使用者介面設定。
See Also
Reference
Get-SPDataConnectionFile
Set-SPDataConnectionFile
Uninstall-SPDataConnectionFile