New-SPAuthenticationProvider

Modulo:

sharepoint-server

Si applica a:

SharePoint Server Subscription Edition

Crea un nuovo provider di autenticazione nella farm.

Sintassi

New-SPAuthenticationProvider
   -ASPNETMembershipProvider <String>
   -ASPNETRoleProviderName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

New-SPAuthenticationProvider
   -TrustedIdentityTokenIssuer <SPTrustedIdentityTokenIssuerPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

New-SPAuthenticationProvider
   [-AllowAnonymous]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-DisableKerberos]
   [-UseBasicAuthentication]
   [-UseWindowsIntegratedAuthentication]
   [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il cmdlet New-SPAuthenticationProvider crea un nuovo provider di autenticazione nella farm.

- NTLM, Classic NTLM, Negotiate e Classic Negotiate possono essere impostati solo in un'applicazione Web. - Per i provider di ruoli o appartenenze ASP.NET non vengono salvati oggetti in modo permanente. L'oggetto viene creato e utilizzato solo per impostare questo tipo di provider di autenticazione in un'applicazione Web. - Per i provider di autenticazione STS l'oggetto viene creato e salvato in modo permanente nell'oggetto SPFarm.

Non è consentito l'utilizzo di Classic NTLM con alcun tipo di autenticazione basata sulle attestazioni.

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 1------------------

$ap = New-SPAuthenticationProvider -UseWindowsIntegratedAuthentication
Set-SPWebApplication -Name "Claims Windows Web App" -ApplicationPool "Claims App Pool" -ApplicationPoolAccount "redmond\appool" -Url http://<servername> -Port 80 -AuthenticationProvider $ap

In questo esempio viene creato un provider di autenticazione basata sulle attestazioni di Windows.

---------------------------EXAMPLE2------------------

$ap = New-SPAuthenticationProvider -ASPNETMembershipProvider "membership" -ASPNETRoleProviderName "rolemanager"
Set-SPWebApplication -Name "Claims Windows Web App" -ApplicationPool "Claims App Pool" -ApplicationPoolAccount "redmond\appool" -Url http://<servername> -Port 80 -AuthenticationProvider $ap

In questo esempio viene creato un provider di autenticazione basato sul provider di ruoli di appartenenze ASP.NET.

---------------------------EXAMPLE3------------------

$ap = New-SPAuthenticationProvider -TrustedIdentityTokenIssuer | Get-SPTrustedIdentityTokenIssuer "LiveIDSTS"
Set-SPWebApplication -Name "Claims Windows Web App" -ApplicationPool "Claims App Pool" -ApplicationPoolAccount "redmond\appool" -Url http://<servername> -Port 80 -AuthenticationProvider $ap

Questo esempio consente di creare un provider di autenticazione di tipo autorità emittente di token attendibile.

Parametri

-AllowAnonymous

Specifica se l'applicazione Web consente l'accesso anonimo.

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

-ASPNETMembershipProvider

Specifica il nome del provider di appartenenze.

Il valore deve essere un nome valido di un provider di appartenenze ASP.NET, ad esempio ProviderAppartenenze.

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

-ASPNETRoleProviderName

Specifica il nome del provider di ruoli.

Il valore deve essere un nome valido di un provider di ruoli ASP.NET, ad esempio ProviderRuoli.

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

-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 Subscription Edition

-DisableKerberos

Specifica se l'applicazione Web disabilita l'autenticazione Kerberos.

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

-TrustedIdentityTokenIssuer

Specifica l'identità del provider di autenticazione.

Il valore deve essere in uno dei formati seguenti:

--Guid valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh --Nome valido di un TrustedIdentityTokenIssuer (ad esempio, myRoleProvider) -- Istanza di un oggetto SPTrustedIdentityTokenIssuer valido

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

-UseBasicAuthentication

Specifica se l'applicazione Web utilizza l'autenticazione di base.

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

-UseWindowsIntegratedAuthentication

Specifica se l'applicazione Web utilizza l'autenticazione integrata di Windows.

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