New-SPODataConnectionSetting
建立新的 Business Data Connectivity Service 連線。
Syntax
New-SPODataConnectionSetting
-AuthenticationMode <ODataAuthenticationMode>
-ServiceAddressURL <Uri>
-ServiceContext <SPServiceContextPipeBind>
-Name <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-ExtensionProvider <String>]
[-SecureStoreTargetApplicationId <String>]
[<CommonParameters>] Description
使用 New-SPODataConnectionSetting Cmdlet 可在伺服器陣列中建立新的 Business Data Connectivity Service 連線及其相關聯的中繼資料屬性。
若要查看此中繼資料設定，請使用 Get-SPODataConnectionSettingMetaData Cmdlet。
此 Cmdlet 僅適用於內部部署環境。 您無法在 SharePoint Online Management Shell 中使用此命令。
如需適用於 SharePoint 產品和技術的 Windows PowerShell 權限和最新資訊，請參閱線上文件 https://go.microsoft.com/fwlink/p/?LinkId=251831 (https://go.microsoft.com/fwlink/p/?LinkId=251831).。
範例
------------------範例------------------
New-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -ServiceAddressURL "https://expensereporting.cloudapp.net/expensereporting.svc" -AuthenticationMode "Credentials" -SecureStoreTargetApplicationId "DallasUserName"此範例會建立名爲 ContosoServiceApp 的新 Business Data Connectivity Service 連線。
過程中會建立 Microsoft Business Connectivity Services 連線中繼資料物件。
參數
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-AuthenticationMode
指定 Business Connectivity Services 連線所需的驗證模式類型。
驗證模式的值為下列任一選項：
| Type: | ODataAuthenticationMode |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-ExtensionProvider
指定 Business Connectivity Services 連線的 ODataExtensionProvider。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-Name
指定 Business Connectivity Services 連線物件的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-SecureStoreTargetApplicationId
指定 Secure Store 目標應用程式識別碼。 與 AuthenticationMode 參數搭配使用。
SecureStoreTargetApplicationId 參數的值為下列任一選項：
--Credentials --WindowsCredentials --DigestCredentials --ClientCertificate
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-ServiceAddressURL
指定 OData 服務的 URL。 此 URL 不需要對網際網路開放。 這是要從中擷取資料的最終目的地。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-ServiceContext
指定 SPServiceContext 物件執行個體形式的服務內容、 SPSiteAdministration 物件識別碼或 SPSite 物件。 服務內容值範例包括：來自識別碼欄位的識別碼、字串識別碼、URI 或 GUID 的字串表示法。
| Type: | SPServiceContextPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016 |