Convert-SPWebApplication

Konvertiert den Authentifizierungsmodus einer Webanwendung.

Syntax

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

Beschreibung

Verwenden Sie das Convert-SPWebApplication-Cmdlet, um den Authentifizierungsmodus einer Webanwendung in den Modus Windows-Forderungsauthentifizierung zu konvertieren und die Benutzerkonten in den Inhaltsdatenbank zu forderungscodierten Werten zu migrieren.

Wenn Berechtigungen beibehalten werden, werden Benutzer innerhalb von Websites nur konvertiert, wenn das Quellkonto von SharePoint aktiviert und abgefragt werden kann. Wenn das Active Directory-Konto beispielsweise vor einer Klassischen Windows-in-Windows-Anspruchskonvertierung gelöscht oder deaktiviert wird, wird das Konto in der Datenbank nicht auf das Anspruchsformat aktualisiert.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

------------BEISPIEL 1-------

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

In diesem Beispiel wird eine mit dem Parameter Identity angegebene Webanwendung konvertiert, um den Forderungsauthentifizierungsmodus zu verwenden.

------------BEISPIEL 2-------

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

In diesem Beispiel wird eine Webanwendung, die durch den Identity-Parameter angegeben wird, von der klassischen Windows-Authentifizierung in den Anspruchsauthentifizierungsmodus konvertiert, wobei die Berechtigungen beibehalten werden. Der Parameter -From ist erforderlich, nachdem das Sicherheitsupdate MS04-022 oder das kumulative Update vom April 2014 für SharePoint Server 2013 angewendet wurde. Dies ist für alle Versionen von SharePoint Server 2016 erforderlich.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

Gibt den Namen der zu migrierenden Inhaltsdatenbank an.

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

Erzwingt die Konvertierung der Webanwendung.

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

Gibt die Authentifizierungsmethode an, aus der konvertiert werden soll.

Gültige Werte für diesen Parameter sind wie folgt.

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

Gibt die URL der Webanwendung an, die konvertiert werden soll, z. B. 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

Gibt ein Verzeichnis an, in dem ausführliche Protokolle zu den Ergebnissen der Migration geschrieben werden.

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

Gibt eine Datei an, die als Liste von Zeilen im folgenden Format enthält: 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

Gibt das Konto an, unter dem das Cmdlet ausgeführt wird, und behält die Berechtigungen in der Webanwendung bei.

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

Gibt die GUID für das Websiteabonnement an.

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

Gibt an, dass die SPWebApplication-Sicherheitsrichtlinien nicht migriert werden.

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

Gibt an, dass die SPSites der SPWebApplication nicht migriert werden.

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

Gibt eine Datei an, die als Liste von Zeilen im folgenden Format enthält: 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

Gibt die Authentifizierungsmethode an, in die konvertiert werden soll.

Gültige Werte für diesen Parameter sind wie folgt.

Claims, 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

Wenn Sie von einem vertrauenswürdigen Anmeldeanbieter migrieren, geben Sie den vertrauenswürdigen Anmeldeanbieter an.

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