Convert-SPWebApplication

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

Converte la modalità di autenticazione di un'applicazione Web.

Sintassi

Convert-SPWebApplication
       -Identity <SPWebApplicationPipeBind>
       -From <String>
       -To <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Force]
       [-RetainPermissions]
       [-Database <SPContentDatabase>]
       [-MapList <String>]
       [-SiteSubsriptionId <Guid>]
       [-SkipPolicies]
       [-SkipSites]
       [-SourceSkipList <String>]
       [-TrustedProvider <SPTrustedIdentityTokenIssuerPipeBind>]
       [-LoggingDirectory <String>]
       [<CommonParameters>]

Descrizione

Utilizzare il cmdlet Convert-SPWebApplication per convertire la modalità di autenticazione di un'applicazione Web alla modalità di autenticazione basata sulle attestazioni di Windows ed eseguire la migrazione degli account utente del database del contenuto in valori codificati come attestazioni.

Quando si mantengono le autorizzazioni, gli utenti all'interno di Siti vengono convertiti solo se l'account di origine è abilitato ed è possibile eseguire query da SharePoint. Ad esempio, se l'account di Active Directory viene eliminato o disabilitato prima di una conversione classica delle attestazioni da Windows a Windows, l'account nel database non verrà aggiornato al formato 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-------

Convert-SPWebApplication -Identity "https://<webappurl>" -To Claims -RetainPermissions

In questo esempio un'applicazione Web specificata dal parametro Identity viene convertita per l'utilizzo della modalità di autenticazione basata sulle attestazioni.

------------ESEMPIO 2-------

Convert-SPWebApplication -Identity "https://<webappurl>" -From Legacy -To Claims -RetainPermissions

In questo esempio viene convertita un'applicazione Web specificata dal parametro Identity dalla autenticazione di Windows classica alla modalità di autenticazione attestazioni mantenendo le autorizzazioni. Il parametro -From è necessario dopo l'aggiornamento della sicurezza MS04-022 o l'aggiornamento cumulativo di aprile 2014 per SharePoint Server 2013. Questa operazione è necessaria per tutte le versioni di SharePoint Server 2016.

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

-Database

Specifica il nome del database del contenuto di cui eseguire la migrazione.

Type:SPContentDatabase
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

-Force

Forza la conversione dell'applicazione Web.

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

-From

Specifica il metodo di autenticazione da cui eseguire la conversione.

I valori validi per questo parametro sono i seguenti.

Legacy, Claims-Windows, Claims-Trusted-Default

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

-Identity

Specifica l'URL dell'applicazione Web che si desidera convertire, ad esempio https://mysite/app1

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

-LoggingDirectory

Specifica una directory in cui verranno scritti log dettagliati sui risultati della migrazione.

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

-MapList

Specifica un file contenente come elenco di righe nel formato seguente: user-key, migrated-user-name, migrated-user-key.

Type:String
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

-RetainPermissions

Specifica l'account con cui il cmdlet viene eseguito e mantiene l'autorizzazione nell'applicazione Web.

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

-SiteSubsriptionId

Specifica il GUID per la sottoscrizione del sito.

Type:Guid
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

-SkipPolicies

Specifica che i criteri di sicurezza SPWebApplication non verranno migrati.

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

-SkipSites

Specifica che non verrà eseguita la migrazione di SPSites di SPWebApplication.

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

-SourceSkipList

Specifica un file contenente come elenco di righe nel formato seguente: user-key.

Type:String
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

-To

Specifica il metodo di autenticazione in cui eseguire la conversione.

I valori validi per questo parametro sono i seguenti.

Attestazioni, Claims-Windows, Claims-Trusted-Default, Claims-SharePoint-Online

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

-TrustedProvider

Quando si esegue la migrazione da un provider di accesso attendibile, questo è il modo in cui si specifica quale provider di account di accesso attendibile.

Type:SPTrustedIdentityTokenIssuerPipeBind
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