Set-SPTrustedIdentityTokenIssuer

设置 Web 应用程序的身份提供程序。

语法

ImportCertificateParameterSet

Set-SPTrustedIdentityTokenIssuer
    [-Identity] <SPTrustedIdentityTokenIssuerPipeBind>
    -ImportTrustCertificate <X509Certificate2>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-ClaimProvider <SPClaimProviderPipeBind>]
    [-ClaimsMappings <SPClaimMappingPipeBind[]>]
    [-Description <String>]
    [-Realm <String>]
    [-SignInUrl <String>]
    [-UseWReply]
    [-Confirm]
    [-RegisteredIssuerName <String>]
    [-WhatIf]
    [<CommonParameters>]

MetadataEndPointParameterSet

Set-SPTrustedIdentityTokenIssuer
    [-Identity] <SPTrustedIdentityTokenIssuerPipeBind>
    -MetadataEndPoint <Uri>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-ClaimProvider <SPClaimProviderPipeBind>]
    [-ClaimsMappings <SPClaimMappingPipeBind[]>]
    [-Description <String>]
    [-Realm <String>]
    [-SignInUrl <String>]
    [-UseWReply]
    [-Confirm]
    [-RegisteredIssuerName <String>]
    [-WhatIf]
    [<CommonParameters>]

说明

Set-SPTrustedIdentityTokenIssuer cmdlet 设置 Web 应用程序或扩展 Web 应用程序的标识提供者。 对于 ASP.NET 成员资格提供程序和角色提供程序,仅当结果通过管道传递给变量并传递给 Web 应用程序时,此 cmdlet 才会更改标识提供者。 对于 (STS) 标识提供者的安全令牌服务,此 cmdlet 更改 SPFarm 对象中的持久标识提供者对象。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

示例 1

Set-SPTrustedIdentityTokenIssuer "LiveIDSTS" -Certificate (Get-ChildItem"cert:Certificates (LocalComputer)\Personal\Certificates -Name "LiveID Cert")

此示例将标识提供者设置为 LiveIDSTS。

示例 2

C:\PS>$ip = @( (Get-SPTrustedIdentityTokenIssuer "LiveID STS"), (New-SPTrustedIdentityTokenIssuer -ASPNetMembershipProvider "myMembershipProvider" -ASPNetRoleProvider "myRoleProvider"), (Get-SPTrustedIdentityTokenIssuer "NTLM")) )
New-SPWebApplication https://contoso.com -IdentityProvider $ip

此示例使用 .ASPNetMembership 和 Role 参数设置身份提供程序。 使用这些参数时,必须设置变量;否则,值不起作用。

参数

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

使用全局参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClaimProvider

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定可以解析和搜索声明人员选取器声明的 IP STS。

键入的值必须是有效的 GUID,形式为 12345678-90ab-cdef-1234-567890bcdefgh;或声明提供程序的有效名称(例如,MyIDprovider1);或有效的 SPClaimProvider 对象的实例。

参数属性

类型:SPClaimProviderPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClaimsMappings

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定从原始令牌到 SharePoint 令牌的声明的映射。

键入的值必须是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);或是声明映射规则的有效名称(例如,Email)或有效的 SPClaimMapping 对象的实例。

参数属性

类型:

SPClaimMappingPipeBind[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

提示你在运行 cmdlet 之前进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Description

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定新标识提供程序的说明。

键入的值必须为有效字符串;例如,LiveID STS。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要更新的身份提供程序。

键入的值是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);是标识提供程序的有效名称(例如 LiveID STS);或者是有效 SPIdentityProvider 对象的实例。

参数属性

类型:SPTrustedIdentityTokenIssuerPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ImportTrustCertificate

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定受信任的验证提供程序服务器场的 X.509 证书对象。

键入的值必须是有效的 X.509 证书名称;例如,Certificate1。

参数属性

类型:X509Certificate2
默认值:None
支持通配符:False
不显示:False

参数集

ImportCertificateParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MetadataEndPoint

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

MetadataEndPointParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Realm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定与此信任关联的领域或资源分区。

键入的值必须为有效领域的名称;例如,MD_REALM。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RegisteredIssuerName

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

{{Fill RegisteredIssuerName Description}}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SignInUrl

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定此受信任的身份提供程序 STS 的登录 URL。

The type must be a valid URL, in the form https://int.live.com/.

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UseWReply

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

随令牌请求一起包含 WReply。 WReply 是信赖方的 URL,注销处理完成后,请求者会重定向到此 URL。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters