Remove-SPODataConnectionSetting
適用先:SharePoint Foundation 2013, SharePoint Server 2013 Enterprise
トピックの最終更新日:2015-03-09
Business Connectivity Services 接続を削除します。
Remove-SPODataConnectionSetting -Name <String> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Remove-SPODataConnectionSetting [-Identity] <ODataConnectionSettings> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
このコマンドレットには、複数のパラメーター セットが含まれています。使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。パラメーター セットの使用法に関する詳しい情報については、「Cmdlet Parameter Sets」を参照してください。
Remove-SPODataConnectionSetting コマンドレットは、ファーム内の特定の Business Connectivity Services サービス アプリケーションの 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 | 適切な破棄を行うためにオブジェクトを管理します。SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されると、オブジェクトは自動的に破棄されます。
| ||
Confirm | 省略可 | System.Management.Automation.SwitchParameter | コマンドを実行する前に確認メッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters | ||
WhatIf | 省略可 | System.Management.Automation.SwitchParameter | コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters |
--------------- 例 1 --------------
Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp"
この例では、Business Connectivity Services 接続 ContosoServiceApp を削除します。メタデータのプロパティも削除されます。
--------------- 例 2 --------------
Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp-metadata"
この例では、Business Connectivity Services 接続メタデータ ContosoServiceApp を削除します。
関連する Business Connectivity Services 接続オブジェクトも削除されます。
--------------- 例 3 --------------
$ConnectionVariable = Get-SPODataConnectionSettingMetadata -ServiceContext http://contoso -Name "ContosoServiceApp"
Remove-SPODataConnectionSetting -Identity $ConnectionVariable -ServiceContext "http://contoso"
この例では、Business Connectivity Services 接続と、ContosoServiceApp という名前の関連するメタデータ接続を削除します。