New-SPODataConnectionSetting

 

適用先:SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

トピックの最終更新日:2015-03-09

新しい Business Data Connectivity Service 接続を作成します。

New-SPODataConnectionSetting -AuthenticationMode <PassThrough | RevertToSelf | Credentials | WindowsCredentials | DigestCredentials | ClientCertificate | Anonymous> -Name <String> -ServiceAddressURL <Uri> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-ExtensionProvider <String>] [-SecureStoreTargetApplicationId <String>]

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

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

SharePoint 管理シェル

 

パラメーター 必須 説明

AuthenticationMode

必須

Microsoft.SharePoint.BusinessData.SystemSpecific.OData.ODataAuthenticationMode

Business Connectivity Services 接続に必要な認証モードの種類を指定します。

認証モードの値には、以下のいずれかのオプションを指定します。

 

--PassThrough

--RevertToSelf

--Credentials

--WindowsCredentials

--DigestCredentials

--ClientCertificate

--Anonymous

ServiceAddressURL

必須

System.Uri

OData サービスの URL を指定します。インターネットに接続することのない URL です。これはデータが取り出される最終的な場所です。

ServiceContext

必須

Microsoft.SharePoint.PowerShell.SPServiceContextPipeBind

サービス コンテキストを SPServiceContext オブジェクトのインスタンス、SPSiteAdministration オブジェクトの識別子、SPSite オブジェクトのいずれかの形式で指定します。たとえば、サービス コンテキストの値には、ID フィールド内の識別子、文字列識別子、URI、GUID の文字列表現などがあります。

Name

必須

System.String

ユーザーが参照するプロパティを持つ Business Connectivity Services 接続の名前を指定します。

AssignmentCollection

省略可

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

メモメモ:
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

ExtensionProvider

省略可

System.String

Business Connectivity Service で OData コネクタが提供する機能を拡張し、OData 拡張機能プロバイダーの完全修飾アセンブリ名を指定します。完全修飾アセンブリ名には次のパラメーターを次の順序で含める必要があります。

名前空間.クラス、アセンブリ名、バージョン、カルチャ、および公開キー。例、"Contoso.ExtensionProvider.Server, Contoso.ExtensionPRovider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31ba4812ca364d35"。ExtensionProvider の値をクリアするには、"" のように空の文字列を指定します。

SecureStoreTargetApplicationId

省略可

System.String

Secure Store のターゲット アプリケーション ID を指定します。AuthenticationMode パラメーターと連携して動作します。

SecureStoreTargetApplicationId パラメーターの値には、以下のいずれかのオプションを指定します。

--Credentials

--WindowsCredentials

--DigestCredentials

--ClientCertificate

-------------- 例 --------------

New-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -ServiceAddressURL "https://expensereporting.cloudapp.net/expensereporting.svc" -AuthenticationMode "Credentials" -SecureStoreTargetApplicationId "DallasUserName" -ExtensionProvider "Contoso.ExtensionProvider.Server, Contoso.ExtensionPRovider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31ba4812ca364d35"

この例では、新しい Business Data Connectivity Service 接続 ContosoServiceApp を作成します。

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

表示: