Remove-SPODataConnectionSetting
Удаляет подключение Business Connectivity Services.
Синтаксис
Remove-SPODataConnectionSetting
[-Identity] <ODataConnectionSettings>
-ServiceContext <SPServiceContextPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Remove-SPODataConnectionSetting
-ServiceContext <SPServiceContextPipeBind>
-Name <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Командлет Remove-SPODataConnectionSetting
удаляет подключение Business Connectivity Services из заданного приложения-службы Business Connectivity Services в ферме.
Также удаляется объект метаданных, связанный с подключением Business Connectivity Services.
Этот командлет предназначен только для локальной среды. Невозможно использовать его в командной консоли SharePoint Online.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
-----------------------ПРИМЕР 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.
Параметры
-AssignmentCollection
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра 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 |
-Confirm
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016 |
-Identity
Задает объект параметров подключения OData.
Type: | ODataConnectionSettings |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-ServiceContext
Задает контекст службы, который имеет форму экземпляра объекта SPServiceContext, идентификатора объекта SPSiteAdministration или объекта SPSite. В качестве примера значения контекста службы можно привести идентификатор из поля ИД, строковый идентификатор, 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 |
-WhatIf
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016 |