New-SPODataConnectionSetting
新しい 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 |