New-SPClaimTypeMapping
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
建立安全性權杖服務 (STS) 身分識別提供者的宣告對應規則。
Syntax
New-SPClaimTypeMapping [-IncomingClaimType] <String> [-IncomingClaimTypeDisplayName] <String> [[-LocalClaimType] <String>] [-AssignmentCollection <SPAssignmentCollection>] [-SameAsIncoming <SwitchParameter>]
詳細描述
New-SPClaimTypeMapping Cmdlet 會建立 Security Token Service (STS) 身分識別提供者的宣告對應規則。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
IncomingClaimType |
必要 |
System.String |
指定傳入宣告類型的 URI。 此類型必須是格式為 https://schemas.microsoft.com/email 的 URI。 |
IncomingClaimTypeDisplayName |
必要 |
System.String |
指定傳入宣告類型的顯示名稱。 此類型必須是傳入宣告類型的有效名稱，例如 Email。 |
LocalClaimType |
選用 |
System.String |
指定本機宣告類型的 URI。SameAsIncoming 參數若為 False，此即為必要參數。 此類型必須是格式為 https://schemas.microsoft.com/email 的 URI。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
SameAsIncoming |
選用 |
System.Management.Automation.SwitchParameter |
指定 IncomingClaimType 參數中所指定的宣告類型要用於 LocalClaimType 參數。 |
輸入類型
傳回類型
Example
--------------------範例 1----------------------------
$map1 = New-SPClaimTypeMapping -IncomingClaimType "https://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress" -IncomingClaimTypeDisplayName "EmailAddress" -SameAsIncoming
$map2 = New-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"
New-SPTrustedIdentityTokenIssuer -Name "LiveIDSTS" -Description "LiveID Provider" -Realm "urn:domain.company.com" -ImportTrustCertificate $cert -ClaimsMappings $map1[,$map2..] -SignInUrl "https://login.live.com/login.srf" -IdentifierClaim $map2.InputClaimType
此範例會建立從內送 Token 到 SharePoint Token 的宣告對應。