Convert-SPWebApplication
Konvertiert den Authentifizierungsmodus einer Webanwendung.
Syntax
Default (Standardwert)
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
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SPAssignmentCollection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Database
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Namen der zu migrierenden Inhaltsdatenbank an.
Parametereigenschaften
| Typ: | SPContentDatabase |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Erzwingt die Konvertierung der Webanwendung.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-From
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt die URL der Webanwendung an, die konvertiert werden soll, z. B. https://mysite/app1.
Parametereigenschaften
| Typ: | SPWebApplicationPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LoggingDirectory
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
Gibt ein Verzeichnis an, in dem ausführliche Protokolle zu den Ergebnissen der Migration geschrieben werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MapList
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt eine Datei an, die als Liste von Zeilen im folgenden Format enthält: User-key, migrated-user-name, migrated-user-key.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RetainPermissions
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt das Konto an, unter dem das Cmdlet ausgeführt wird, und behält die Berechtigungen in der Webanwendung bei.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SiteSubsriptionId
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt die GUID für das Websiteabonnement an.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SkipPolicies
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt an, dass die SPWebApplication-Sicherheitsrichtlinien nicht migriert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SkipSites
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt an, dass die SPSites der SPWebApplication nicht migriert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SourceSkipList
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt eine Datei an, die als Liste von Zeilen im folgenden Format enthält: user-key.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-To
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TrustedProvider
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Wenn Sie von einem vertrauenswürdigen Anmeldeanbieter migrieren, geben Sie den vertrauenswürdigen Anmeldeanbieter an.
Parametereigenschaften
| Typ: | SPTrustedIdentityTokenIssuerPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.