Поделиться через


Set-SPODataConnectionSetting

Задает или обновляет глобальные свойства подключения Microsoft Business Connectivity Services.

Синтаксис

Set-SPODataConnectionSetting
   [-Identity] <ODataConnectionSettings>
   -ServiceContext <SPServiceContextPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMode <ODataAuthenticationMode>]
   [-Confirm]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [-ServiceAddressURL <Uri>]
   [-WhatIf]
   [<CommonParameters>]
Set-SPODataConnectionSetting
   -ServiceContext <SPServiceContextPipeBind>
   -Name <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMode <ODataAuthenticationMode>]
   [-Confirm]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [-ServiceAddressURL <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет Set-SPODataConnectionSetting используется для обновления свойств существующего подключения для отдельных приложений службы Business Connectivity Services.

Этот командлет предназначен только для локальной среды. Невозможно использовать его в командной консоли SharePoint Online.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в документации в Интернете по адресу https://go.microsoft.com/fwlink/p/?LinkId=251831 (https://go.microsoft.com/fwlink/p/?LinkId=251831).

Примеры

-------------ПРИМЕР 1-----------

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

В этом примере обновляются свойства подключения Business Connectivity Services с именем ContosoServiceApp.

-------------ПРИМЕР 2-----------

$ConnectionVariable = Get-SPODataConnectionSetting -ServiceContext http://contoso -Name "ContosoServiceApp"

Set-SPODataConnectionSetting -Identity $ConnectionVariable -AuthenticationMode "PassThrough"

В этом примере обновляются свойства подключения службы Business Connectivity Services с именем ContosoServiceApp.

-------------ПРИМЕР 3-----------

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

В этом примере обновляются свойства подключения 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

-AuthenticationMode

Тип режима проверки подлинности, применяемого к подключению Business Connectivity Services.

Допускаются следующие значения режима проверки подлинности:

--PassThrough --RevertToSelf --Credentials --WindowsCredentials --DigestCredentials --ClientCertificate --Anonymous

Type:ODataAuthenticationMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ExtensionProvider

Задает ODataExtensionProvider для подключения Business Connectivity Services.

Type:String
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

-SecureStoreTargetApplicationId

Задает идентификатор конечного приложения Secure Store. Используется совместно с параметром AuthenticationMode.

Параметр SecureStoreTargetApplicationId может иметь любое из следующих значений:

--Credentials --WindowsCredentials --DigestCredentials --ClientCertificate

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-ServiceAddressURL

Указывает URL-адрес службы OData. URL-адрес не обязательно должен быть выходом из Интернета. Это конечное место назначения, из которого извлекаются данные.

Type:Uri
Position:Named
Default value:None
Required:False
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