Share via


Add-SPClaimTypeMapping

 

適用版本: SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間: 2015-03-09

新增宣告對應至信任的 Security Token Service (STS) 身分識別提供者。

Syntax

Add-SPClaimTypeMapping [-Identity] <SPClaimMappingPipeBind> [-TrustedIdentityTokenIssuer] <SPTrustedIdentityTokenIssuerPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Force <SwitchParameter>]

詳細描述

Add-SPClaimTypeMapping Cmdlet 會新增宣告對應規則至來自伺服器陣列信任的 STS 驗證提供者之 Security Token Service (STS) 身分識別提供者。

如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數 必要 類型 描述

Identity

必要

Microsoft.SharePoint.PowerShell.SPClaimMappingPipeBind

指定會核發身分識別提供者安全性 Token 的伺服器陣列 STS。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的宣告對應規則名稱 (例如 ClaimMap1),或有效之 SPClaimMapping 物件的執行個體。

TrustedIdentityTokenIssuer

必要

Microsoft.SharePoint.PowerShell.SPTrustedIdentityTokenIssuerPipeBind

指定伺服器陣列信任的 Token 簽署者 (STS 驗證提供者)。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的宣告提供者名稱 (例如 MyIDprovider1),或有效之 SPTrustedIdentityTokenIssuer 物件的執行個體。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Force

選用

System.Management.Automation.SwitchParameter

如果已有宣告對應,覆寫它。

輸入類型

傳回類型

Example

------------------範例------------------

Get-SPTrustedIdentityProvider -Name "LiveIDSTS" | Add-SPClaimTypeMapping -IncomingClaimType "https://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier" -IncomingClaimTypeDisplayName "PUID" -LocalClaimType "https://schemas.xmlsoap.org/ws/2005/05/identity/claims/thumbprint"

此範例會新增宣告對應至信任的身分識別 Token 簽署者。

See Also

Reference

New-SPClaimTypeMapping
Remove-SPClaimTypeMapping