New-SPODataConnectionSetting

  • リファレンス
モジュール:
Microsoft.Online.SharePoint.PowerShell
適用対象:
SharePoint Server 2013, SharePoint Server 2016

新しい Business Data Connectivity サービス接続を作成します。

構文

New-SPODataConnectionSetting
   -AuthenticationMode <ODataAuthenticationMode>
   -ServiceAddressURL <Uri>
   -ServiceContext <SPServiceContextPipeBind>
   -Name <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [<CommonParameters>]

説明

New-SPODataConnectionSetting コマンドレットを使用して、ファーム内で新しい Business Data Connectivity サービス接続および関連するメタデータのプロパティを作成します。 メタデータ設定を表示するには、Get-SPODataConnectionSettingMetaData コマンドレットを使用します。

このコマンドレットは、社内環境のみに適用されます。 SharePoint Online 管理シェルではこのコマンドを使用することはできません。

Windows PowerShell for SharePoint 製品の権限の詳細と最新情報については、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 サービス接続を作成します。

このプロセスでは、Microsoft Business Connectivity Services 接続のメタデータ オブジェクトが作成されます。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

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 のターゲット アプリケーション ID を指定します。 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 オブジェクトのいずれかの形式で指定します。 たとえば、サービス コンテキストの値には、ID フィールド内の識別子、文字列識別子、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