Condividi tramite

Convert-SPWebApplication

Modulo:
SharePointServer module

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

Sintassi

Default (impostazione predefinita). 

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

Questo esempio converte 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

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Database

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SPContentDatabase
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Forza la conversione dell'applicazione Web.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-From

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SPWebApplicationPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LoggingDirectory

Applicabile: SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MapList

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RetainPermissions

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SiteSubsriptionId

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il GUID per la sottoscrizione del sito.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SkipPolicies

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica che i criteri di sicurezza SPWebApplication non verranno migrati.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SkipSites

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SourceSkipList

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-To

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TrustedProvider

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.