Remove-SPODataConnectionSetting
**Gilt für:**SharePoint Server 2016
**Letztes Änderungsdatum des Themas:**2015-03-09
Removes a Business Connectivity Services connection.
Syntax
Remove-SPODataConnectionSetting -Name <String> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Remove-SPODataConnectionSetting [-Identity] <ODataConnectionSettings> -ServiceContext <SPServiceContextPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detailed Description
Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Cmdlet-Parametersätze.
Use the Remove-SPODataConnectionSetting cmdlet to remove a Business Connectivity Services connection for a particular Business Connectivity Services service application in the farm.
The metadata object associated with the Business Connectivity Services connection is also deleted.
Hinweis
Dieses Cmdlet ist nur in einer lokalen Umgebung verfügbar. In der SharePoint Online-Verwaltungsshell kann der Befehl nicht verwendet werden.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation in der Referenz zu Windows PowerShell für SharePoint Server 2016.
Parameter
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Required |
Microsoft.SharePoint.BusinessData.SystemSpecific.OData.ODataConnectionSettings |
Specifies the OData Connection Settings object. |
ServiceContext |
Required |
Microsoft.SharePoint.PowerShell.SPServiceContextPipeBind |
Specifies the service context which is in the form of an instance of an SPServiceContext object, an SPSiteAdministration object identifier, or a SPSite object. An example of a service context value is an identifier from the ID field, a string identifier, a URI, or a string representation of a GUID. |
Name |
Required |
System.String |
Specifies the name of the existing Business Connectivity Services connection. |
AssignmentCollection |
Optional |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment -Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb , SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global -Parameter verwendet wird. Hinweis Wenn der Global -Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters |
Input Types
Return Types
Beispiel
----------------EXAMPLE 1------------
Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp"
This example removes the Business Connectivity Services connection named ContosoServiceApp . Metadata properties are also removed.
----------------EXAMPLE 2------------
Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp-metadata"
This example removes the Business Connectivity Services connection metadata named ContosoServiceApp .
The associated Business Connectivity Services connection object is also removed.
----------------EXAMPLE 3------------
$ConnectionVariable = Get-SPODataConnectionSettingMetadata -ServiceContext http://contoso -Name "ContosoServiceApp"
Remove-SPODataConnectionSetting -Identity $ConnectionVariable -ServiceContext "http://contoso"
This example removes the Business Connectivity Services and its associated metadata connection named ContosoServiceApp .
Siehe auch
Get-SPODataConnectionSetting
New-SPODataConnectionSetting
Set-SPODataConnectionSetting