New-SPODataConnectionSetting

  • 參考
模組:
Microsoft.Online.SharePoint.PowerShell
適用於:
SharePoint Server 2013, SharePoint Server 2016

建立新的 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