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>]
说明
此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数,而不能结合使用不同参数集中的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集。
使用 Set-SPODataConnectionSetting
cmdlet 更新特定 Business Connectivity Services 服务应用程序的现有连接的属性。
此 cmdlet 仅适用于本地环境。 您无法在 SharePoint Online 命令行管理程序中使用此命令。
有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 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"
此示例更新名为 ContosoServiceApp 的 Business Connectivity Services 连接的属性。
-------------示例 2-----------
$ConnectionVariable = Get-SPODataConnectionSetting -ServiceContext http://contoso -Name "ContosoServiceApp"
Set-SPODataConnectionSetting -Identity $ConnectionVariable -AuthenticationMode "PassThrough"
此示例更新名为 ContosoServiceApp 的 Business Connectivity Services 服务连接的属性。
-------------示例 3-----------
Set-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -AuthenticationMode "PassThrough" -ExtensionProvider ""
此示例更新名为 ContosoServiceApp 的 Business Connectivity Services 连接的属性,已更改身份验证模式并清除扩展提供程序值。
参数
-AssignmentCollection
管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 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
指定 Business Connectivity Services 连接的 ODataExtensionProvider。
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
指定安全存储目标应用程序 ID。 与 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
指定 OData 服务的 URL。 该 URL 不必是面向 Internet 的。 这是从中检索数据的最终目标位置。
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 对象的实例:服务上下文值的示例是来自 ID 字段的标识符、字符串标识符、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 |
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈