Backup-SPFarm
Erstellt eine Datensicherung für eine einzelne Datenbank, Webanwendung oder die gesamte Farm.
Syntax
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Backup-SPFarm
[-ShowTree]
[-AssignmentCollection <SPAssignmentCollection>]
[-ConfigurationOnly]
[-Item <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Beschreibung
Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.
Das Cmdlet Backup-SPFarm erstellt eine Datensicherung der gesamten Farm oder von einzelnen Komponenten in der Farm. Es kann auch verwendet werden, um nur die Konfigurationseinstellungen einer Farm zu sichern, die dann als Farmvorlage für andere SharePoint-Farmen verwendet werden können. Wenn eine einzelne Websitesammlung gesichert werden soll, verwenden Sie das Cmdlet Backup-SPSite.
Verwenden Sie den Parametersatz, um die verfügbaren Objekte anzuzeigen, die -ShowTree gesichert werden sollen.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
------------------BEISPIEL 1-----------------------
Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnlyIn diesem Beispiel werden die Konfigurationseinstellungen der Farm im Verzeichnis \\file_server\share\Backup gesichert.
------------------BEISPIEL 2-----------------------
Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -VerboseIn diesem Beispiel wird angezeigt, welche Komponenten der Farm im Knoten Microsoft SharePoint Foundation Web Application gesichert würden, es erfolgt jedoch keine tatsächliche Sicherung.
------------------BEISPIEL 3-----------------------
Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -ForceIn diesem Beispiel wird eine Farm unter Verwendung von 10 Threads gesichert und die Speicherung der Datensicherung im Verzeichnis C:\Backup erzwungen, und zwar auch dann, wenn SharePoint davon ausgeht, dass nicht genügend Speicherplatz vorhanden ist.
--------------------BEISPIEL 4---------------------
Backup-SPFarm -ShowTreeIn diesem Beispiel werden die verfügbaren Objekte gezeigt, die mit Backup-SPFarmgesichert werden sollen.
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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-BackupMethod
Gibt den Typ der zu erstellenden Datensicherungsdatei an.
Wenn eine Sicherung mit dem Parameter -ShowTree ausgeführt wird, wird der Parameter BackupMethod nicht verwendet.
Bei einer vollständigen Sicherung werden alle ausgewählten Daten gesichert. Bei einer differenziellen Sicherung werden alle ausgewählten Daten, die seit der letzten vollständigen Sicherung geändert wurden, gesichert. Wenn ein Element keine differenziellen Sicherungen unterstützt, wird für dieses Element stattdessen eine vollständige Sicherung ausgeführt.
Bei dem Typ muss es sich um einen der folgenden handeln:
- Vollständig
- Differenzielle
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-BackupThreads
Gibt die Anzahl der Threads an, die während der Sicherung verwendet werden sollen. Je weniger Threads, desto einfacher ist die Sicherungsprotokolldatei zu lesen und zu verstehen. Je mehr Threads, desto mehr Komponenten können in parallet gesichert werden, was zu einem schnelleren Sicherungsvorgang führen kann. Der Mindestwert ist 1 und der Höchstwert 10.
Der Standardwert ist 3.
Wenn eine Sicherung mit dem Parameter -ShowTree ausgeführt wird, wird der Parameter BackupMethod nicht verwendet.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ConfigurationOnly
Bei Angabe dieses Parameters enthält die Datensicherung nur Konfigurationseinstellungen (keine Daten) für jedes der zu sichernden Objekte.
SharePoint überschätzt möglicherweise die Menge an Speicherplatz, der für eine reine Konfigurationssicherung erforderlich ist, was dazu führen kann, dass SharePoint schätzt, dass nicht genügend Speicherplatz vorhanden ist, um die Sicherung im angegebenen Pfad zu speichern. Verwenden Sie in diesem Fall den -Force -Parameter, um mit der Sicherung fortzufahren, wenn Sie über genügend Speicherplatz zum Speichern der reinen Konfigurationssicherung verfügen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Directory
Gibt den Pfad an, in dem SharePoint-Produkte das generierte Sicherungspaket speichert. Wenn Sie über einen Computer verfügen, auf dem SQL Server und eine Instanz von SharePoint-Produkten installiert sind, können Sie lokale Laufwerkspfade verwenden. Dies schließt eine einfache Installation ein. Wenn jedoch SQL Server und SharePoint-Produkte auf mehreren Computern installiert sind oder wenn Sie über mehrere Server verfügen, auf denen SharePoint-Produkte ausgeführt werden, müssen Sie UNC-Freigabepfade (Universal Naming Convention) verwenden, damit die SQL Server Datenbank- und Suchkomponenten an denselben Speicherort geschrieben werden, z. B. \\computer_name\volume\Backup).
An einem Speicherort können mehrere Sicherungspakete gespeichert werden. Dies ist derselbe Pfad, den Sie an den Directory -Parameter des Cmdlets Restore-SPFarm übergeben.
Bei dem Typ muss es sich um einen der gültigen Pfade handeln:
- C:\Ordnername
- \\server_name\folder_name
Die spbr* -Ordner werden automatisch erstellt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Force
Gibt an, dass ein Datensicherungsvorgang auch dann vorgesetzt werden soll, wenn von der Annahme ausgegangen wird, dass im Datensicherungsverzeichnis nicht genügend Speicherplatz für die gesamte Datensicherung vorhanden ist.
Wenn eine Datensicherung mit dem Parameter ShowTree erstellt wird, wird der Parameter Force nicht verwendet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Item
Gibt den Teil der Serverfarm an, der gesichert werden soll. Sie können die vollständige Farmpfadangabe verwenden, die durch den ShowTree -Parameter oder den Namen der Zielkomponente im Pfad angezeigt wird, wenn der eindeutige Name der Komponente vorliegt. Wenn mehrere übereinstimmende Elemente vorhanden sind, muss der vollständige Pfad angegeben werden. Standardmäßig wird der oberste Knoten ausgewählt. Schließen Sie das Element oder den Pfad in Anführungszeichen ein, falls der Name Leerzeichen enthält. Wenn dieser Parameter nicht angegeben wird, wird die gesamte Serverfarm gesichert.
Der Typ muss ein gültiges Element sein. Beispiel: Farm\Microsoft SharePoint Foundation-Webanwendung\SharePoint - 80.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Percentage
Fordert die Anzeige von Fortschrittsaktualisierungen für den Datensicherungsvorgang unter Verwendung dieses inkrementellen Fertigstellungsprozentsatzes an (z. B. werden mit dem Wert 5 Fortschrittsaktualisierungen für die Sicherung in Schritten von jeweils 5 % angezeigt, und mit dem Wert 10 in Schritten von jeweils 10 %). Damit die Fortschrittsausgaben angezeigt werden, muss der Parameter Verbose angegeben werden.
Dieser Prozentsatz ist nicht wirklich präzise, und die tatsächlichen Fortschrittsaktualisierungen können niedriger oder höher sein. Fortschrittsaktualisierungen werden immer in der Sicherungsprotokolldatei aufgezeichnet.
Die Prozentsatzangabe ist nicht genau, und die tatsächlichen Fortschrittsaktualisierungen können niedriger oder höher als angefordert sein.
Der Standardwert ist 5. Bei einer sehr großen Datenbank ist 1 der empfohlene Wert.
Gültige Werte sind eine ganze Zahl zwischen 1 und 100.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ShowTree
Zeigt an, welche Objekte in der Serverfarm basierend auf den anderen Parametern gesichert werden, die an das Cmdlet Backup-SPFarm übergeben werden (also im Prinzip der Item -Parameter). Elementen, die basierend auf den anderen Parametern, die an das Cmdlet Backup-SPFarm übergeben werden, von der Sicherung ausgeschlossen werden, ist ein Sternchen (*) vorangestellt. Elemente, die nicht gesichert werden können, sind in eckige Klammern ([ ]) eingeschlossen. Wenn der ShowTree -Parameter vorhanden ist, wird keine Sicherung ausgeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |