Backup-SPConfigurationDatabase

Referenz

Modul:: SharePointServer

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

Sichert nur die Konfiguration auf Farmebene.

Syntax

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]

Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<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.

Mit dem Cmdlet Backup-SPConfigurationDatabase wird nur die Konfiguration der aktuellen Farm oder nur die Konfiguration einer separaten Konfigurationsdatenbank gesichert, die nicht an die aktuelle Farm angefügt ist. Wenn Sie nur die Konfiguration der aktuellen Farm sichern möchten, ist es nicht erforderlich, die Parameter DatabaseServer und DatabaseName anzugeben. Für ein solches Szenario wird jedoch empfohlen, das Cmdlet Backup-SPFarm mit dem Parameter ConfigurationOnly zu verwenden.

Beispiel für eine Konfigurationssicherung: Ein Administrator erstellt eine Konfigurationsvorlage für die Farm, die dann auf andere SharePoint-Farmen angewendet werden kann, indem mithilfe des Cmdlets Restore-SPFarm eine Wiederherstellung ausgeführt wird.

Berechtigungen und aktuelle Informationen zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251831.

Beispiele

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

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

In diesem Beispiel werden Komponenten angezeigt, die bei einer Konfigurationssicherung berücksichtigt werden können.

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

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

In diesem Beispiel wird nur die Konfiguration gesichert und eine ausführliche Ausgabe erstellt.

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

-DatabaseCredentials

Gibt die ID und das Kennwort an, die dem Administratorbenutzernamen für die SQL Server-Datenbank entsprechen.

Dieser Parameter sollte nur angegeben werden, wenn zum Herstellen der Verbindung mit der Datenbank die SQL-Authentifizierung verwendet wird. Wenn die Windows-Authentifizierung verwendet wird, um die Verbindung mit der Datenbank herzustellen, sollte dieser Parameter nicht angegeben werden.

Type:	PSCredential
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

-DatabaseName

Gibt den Namen der Konfigurationsdatenbank an.

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

-DatabaseServer

Gibt den SQL-Datenbankserver an, der die Konfigurationsdatenbank enthält. Die Standardeinstellung ist der Name des lokalen Computers.

Bei dem Typ muss es sich um einen gültigen Datenbankserver handeln, z. B. DS.

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

-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

-Item

Gibt den Teil der Serverfarm an, der gesichert werden soll. Sie können die vollständige Farmpfadangabe verwenden, die durch den ShowTree -Parameter angezeigt wird, oder den Namen der Zielkomponente im Pfad, wenn die Komponente einen eindeutigen Namen besitzt. Wenn mehrere Elemente mit dem Namen übereinstimmen, muss der vollständige Pfad angegeben werden. Schließen Sie das Element oder den Pfad in Anführungszeichen ein, falls der Name Leerzeichen enthält.

Wenn der Parameter Item nicht angegeben wird, wird die gesamte Farmkonfiguration gesichert.

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

-ShowTree

Zeigt an, welche Objekte in der Farm basierend auf den anderen Parametern gesichert werden, die an das Cmdlet für die Sicherung übergeben werden, (also im Prinzip der Item -Parameter). Elementen, die basierend auf den anderen Parametern, die an das Cmdlet Backup-SPConfigurationDatabase ü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