New-SPClaimTypeMapping

建立 Security Token Service (STS) 身分識別提供者的宣告對應規則。

Syntax

New-SPClaimTypeMapping
   [-IncomingClaimType] <String>
   [-IncomingClaimTypeDisplayName] <String>
   [[-LocalClaimType] <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-SameAsIncoming]
   [<CommonParameters>]

Description

New-SPClaimTypeMapping Cmdlet 會建立 Security Token Service (STS) 身分識別提供者的宣告對應規則。

如需 SharePoint 產品和技術的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint 伺服器 Cmdlet

範例

--------------------範例 1----------------------------

$map1 = New-SPClaimTypeMapping -IncomingClaimType "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress" -IncomingClaimTypeDisplayName "EmailAddress" -SameAsIncoming
$map2 = New-SPClaimTypeMapping -IncomingClaimType "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier" -IncomingClaimTypeDisplayName "PUID" -LocalClaimType "http://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 的宣告對應。

參數

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-IncomingClaimType

指定傳入宣告類型的 URI。

此類型必須是格式為 http://schemas.microsoft.com/email 的 URI。

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-IncomingClaimTypeDisplayName

指定傳入宣告類型的顯示名稱。

此類型必須是傳入宣告類型的有效名稱,例如 Email。

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-LocalClaimType

Specifies the URI of the local claim type. If the SameAsIncoming parameter is False, this is a required parameter.

此類型必須是格式為 http://schemas.microsoft.com/email 的有效 URI。

Type:String
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SameAsIncoming

指定 IncomingClaimType 參數中所指定的宣告類型要用於 LocalClaimType 參數。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition