Set-SPDataConnectionFile
適用版本： SharePoint Server 2010
上次修改主題的時間： 2015-03-09
設定資料連線檔案的屬性。
Syntax
Set-SPDataConnectionFile [-Identity] <SPDataConnectionFilePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Category <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-WebAccessible <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Set-SPDataConnectionFile cmdlet 可設定 Identity 參數所指定之資料連線檔案的屬性。
如需 Windows PowerShell for SharePoint Server 2010 的權限及最新資訊，請參閱 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.Office.InfoPath.Server.Cmdlet.SPDataConnectionFilePipeBind |
指定所要更新的資料連線檔案。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID；有效的資料連絡檔案名稱 (例如 DataConnectionFileName1.udcx)；或有效之 SPDataConnectionFile 物件的執行個體。 |
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 |
Description |
選擇性 |
System.String |
設定資料連線檔案的描述。此名稱最多可包含 4096 個英數字元。 此類型必須是有效的字串，例如通用資料連線檔案的描述。 |
DisplayName |
選擇性 |
System.String |
指定描述資料連線檔案的顯示名稱。此名稱最多可包含 255 個字元。 此類型必須是有效的字串，例如 InfoPathUDC1。 |
WebAccessible |
選擇性 |
System.String |
指定可以利用 Web 服務進行存取的通用資料連線檔案。若為 False，只有表單伺服器可以從內部擷取通用資料連線檔案。預設值為 False。 |
WhatIf |
選擇性 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
--------------範例-----------------
Set-SPDataConnectionFile -Identity "sample.udcx" -Category "Temp"
此範例會更新指定之 .udcx 檔案的 Category。
--------------範例 2-----------------
Set-SPDataConnectionFile -Identity "sample.udcx" -DisplayName "NewDisplayName"
此範例會更新指定之 .udcx 檔案的 DisplayName。
--------------範例 3-----------------
Sample.udcx" | Set-SPDataConnectionFile -Category "Temp"
此範例會更新指定之 .udcx 檔案的 Category。
--------------範例 4-----------------
Get-SPDataConnectionFile | where {$_.Category -eq "Category1"} | Set-SPDataConnectionFile -Category "Category2"
此範例會更新 Get-SPDataConnectionFile cmdlet 所用查詢傳回之 .udcx 檔案集合的 Category 欄位。
See Also
Reference
Get-SPDataConnectionFile
Install-SPDataConnectionFile
Uninstall-SPDataConnectionFile