Upgrade-SPSite

Referenz

Modul:: SharePointServer

Gilt für::: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Startet den Upgradevorgang für eine Websitesammlung.

Syntax

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Beschreibung

Das Upgrade-SPSite Cmdlet startet den Upgradevorgang für eine Websitesammlung.

Das Upgrade-SPSite Cmdlet aktiviert den Upgradeprozess für das angegebene SPSite-Objekt. Sie können mit diesem Cmdlet außerdem Upgrades fortsetzen, bei denen Fehler aufgetreten sind. Wenn Sie dieses Cmdlet verwenden, um ein Upgrade für ein SPSite-Objekt zu initiieren, kann das Objekt entweder ein Upgrade von einem Build auf einen anderen Build oder ein Upgrade von einer Version auf eine andere Version sein.

Standardmäßig wird das Upgrade-SPSite Cmdlet als Build-zu-Build-Upgrade ausgeführt. Dadurch werden unerwartete Versionsupgrades von Websitesammlungen verhindert, wenn Sie das Cmdlet nach einem Patchvorgang verwenden. Im Modus für Upgrades von Version zu Version werden Integritätsprüfungen für eine Websitesammlung im Reparaturmodus ausgeführt, um sicherzustellen, dass die Websitesammlung die für ein erfolgreiches Upgrade erforderliche Integrität aufweist. Bei einem positiven Ergebnis dieser Prüfung wird das restliche Upgrade ausgeführt.

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

Beispiele

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

Upgrade-SPSite https://<site name>/sites/testsite

In diesem Beispiel wird die vorhandene websitesammlung https://< websitename>/-sites/testsite aktualisiert, indem nur verfügbare Build-to-Build-Upgradeaktionen verwendet werden, die dem aktuellen Betriebsmodus der Websitesammlung zugeordnet sind. Der SPSite.CompatibilityLevel wird durch diesen Vorgang nicht geändert.

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

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

In diesem Beispiel wird die vorhandene Websitesammlung https://< websitename>/-sites/testsite aktualisiert, indem alle verfügbaren Build-zu-Build-Upgradeaktionen verwendet werden, die dem aktuellen Betriebsmodus der Websitesammlung zugeordnet sind, und ein Upgrade von Version zu Version durchgeführt wird.

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

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
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

-Email

Gibt an, ob bei Abschluss des Upgrades einer Websitesammlung eine E-Mail gesendet werden soll.

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

-Identity

Gibt das SPSite-Objekt an, für das Upgradevorgänge ausgeführt werden sollen.

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

-Priority

Gibt die Priorität zum Aktualisieren der Website an.

Folgende Werte sind gültig:

128 – 255 (niedrige Priorität)
11 – 127 (normale Priorität)
0 – 10 (hohe Priorität)

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

-QueueOnly

Gibt an, dass der Standort für ein verzögertes Upgrade, das von einem Zeitgeberauftrag verwaltet wird, in die Warteschlange eingefügt werden soll.

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

-Unthrottled

Gibt einen Farmadministrator zur Umgehung der Drosselung an; dadurch kann eine Websitesammlung auch dann geupgradet werden, wenn in der Drosselung zu viele zu aktualisierende Websitesammlungen vorhanden sind.

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

-VersionUpgrade

Gibt an, dass für das SPSite-Objekt ein Upgrade von Version zu Version ausgeführt werden soll. Wenn Sie diesen Parameter festlegen, werden intern alle verfügbaren Build-zu-Build-Aktionen ausgelöst, die dem aktuellen Betriebsmodus der Websitesammlungen zugeordnet sind. Anschließend werden Version-zu-Version-Aktionen ausgeführt, um die Websitesammlungen in den nächsten Websitesammlungs-Betriebsmodus zu bringen, einschließlich aller neuen Build-zu-Build-Aktionen, die dem neuen Websitesammlungs-Betriebsmodus zugeordnet sind. Wenn Sie diesen Parameter nicht festlegen, werden nur verfügbare Build-zu-Build-Upgradeaktionen ausgelöst, die dem aktuellen Websitesammlungs-Betriebsmodus zugeordnet sind.

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

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
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