Add-SPClaimTypeMapping

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiunge un mapping delle attestazioni a un provider di identità del servizio token di sicurezza (STS).

Sintassi

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

Descrizione

Il cmdlet Add-SPClaimTypeMapping aggiunge una regola di mapping delle attestazioni a un provider di identità del servizio token di sicurezza (STS) da un provider di autenticazione STS della relazione di trust della farm.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO------------------

C:\PS>Get-SPTrustedIdentityTokenIssuer -Name "LiveIDSTS" | Add-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"

Questo esempio consente di aggiungere un mapping delle attestazioni a un'autorità emittente di token di identità attendibile.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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, SharePoint Server 2019

-Force

Sovrascrive la regola di mapping delle attestazioni se esiste già.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica il servizio token di sicurezza (STS) per la farm che emetterà il token di sicurezza per il provider di identità.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di una regola di mapping delle attestazioni (ad esempio MapAttest1) oppure un'istanza di un oggetto SPClaimMapping valido.

Type:SPClaimMappingPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TrustedIdentityTokenIssuer

Specifica l'autorità emittente di token della relazione di trust della farm, ovvero il provider di autenticazione STS.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un provider di autenticazione (ad esempio ProviderID1) oppure un'istanza di un oggetto SPTrustedIdentityTokenIssuer valido.

Type:SPTrustedIdentityTokenIssuerPipeBind
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019