Set-SPODataConnectionSettingMetaData

 

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

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

Business Connectivity Services 接続のメタデータのプロパティを更新します。

Set-SPODataConnectionSettingMetadata -Name <String> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-AuthenticationMode <Nullable>] [-Confirm [<SwitchParameter>]] [-SecureStoreTargetApplicationId <String>] [-ServiceAddressMetadataURL <Uri>] [-WhatIf [<SwitchParameter>]]
Set-SPODataConnectionSettingMetadata [-Identity] <ODataConnectionSettings> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-AuthenticationMode <Nullable>] [-Confirm [<SwitchParameter>]] [-SecureStoreTargetApplicationId <String>] [-ServiceAddressMetadataURL <Uri>] [-WhatIf [<SwitchParameter>]]

このコマンドレットには、複数のパラメーター セットが含まれています。使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。パラメーター セットの使用法に関する詳しい情報については、「Cmdlet Parameter Sets」を参照してください。

Set-SPODataConnectionSettingMetaData コマンドレットを使用して、ファーム内の Business Connectivity Services サービス アプリケーションに対する Business Connectivity Services 接続のプロパティを更新します。

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

SharePoint 管理シェル

 

パラメーター 必須 説明

Identity

必須

Microsoft.SharePoint.BusinessData.SystemSpecific.OData.ODataConnectionSettings

OData 接続設定オブジェクトを指定します。

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 コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

AuthenticationMode

省略可

System.Nullable

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

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

--PassThrough

--RevertToSelf

--Credentials

--WindowsCredentials

--DigestCredentials

--ClientCertificate

--Anonymous

Confirm

省略可

System.Management.Automation.SwitchParameter

コマンドを実行する前に確認メッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

SecureStoreTargetApplicationId

省略可

System.String

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

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

--Credentials

--WindowsCredentials

--DigestCredentials

--ClientCertificate

ServiceAddressMetadataURL

省略可

System.Uri

OData サービスのメタデータ URL を指定します。この URL はインターネット URL である必要はありません。接続用の値を指定しない場合、既定値が使用されます。

WhatIf

省略可

System.Management.Automation.SwitchParameter

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

-------------- 例 1 -------------

Set-SPODataConnectionSettingMetadata -Name "ContosoServiceApp" -ServiceContext "http://contoso" -AuthenticationMode "PassThrough"

この例では、ContosoServiceApp という名前の Business Connectivity Services 接続のメタデータの認証モードを更新します。

-------------- 例 2 -------------

$ConnectionVariable = Get-SPODataConnectionSettingMetadata -ServiceContext  http://contoso -Name "ContosoServiceApp"
Set-SPODataConnectionSettingMetadata -Identity $ConnectionVariable -AuthenticationMode "PassThrough"

この例では、ContosoServiceApp という名前の Business Connectivity Services 接続のメタデータ プロパティを更新します。

表示: