Backup-SqlDatabase

Referenz

Modul:: SQLServer

Sichert SQL Server-Datenbankobjekte.

Syntax

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      [-Path <String[]>]
      [[-BackupFile] <String[]>]
      [-SqlCredential <PSObject>]
      [-BackupDevice <BackupDeviceItem[]>]
      [-PassThru]
      [-Checksum]
      [-ContinueAfterError]
      [-NoRewind]
      [-Restart]
      [-UnloadTapeAfter]
      [-NoRecovery]
      [-DatabaseFile <String[]>]
      [-DatabaseFileGroup <String[]>]
      [-BlockSize <Int32>]
      [-BufferCount <Int32>]
      [-MaxTransferSize <Int32>]
      [-MediaName <String>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-DatabaseObject] <Database>
      [[-BackupFile] <String[]>]
      [-SqlCredential <PSObject>]
      [-BackupDevice <BackupDeviceItem[]>]
      [-PassThru]
      [-Checksum]
      [-ContinueAfterError]
      [-NoRewind]
      [-Restart]
      [-UnloadTapeAfter]
      [-NoRecovery]
      [-DatabaseFile <String[]>]
      [-DatabaseFileGroup <String[]>]
      [-BlockSize <Int32>]
      [-BufferCount <Int32>]
      [-MaxTransferSize <Int32>]
      [-MediaName <String>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -ServerInstance <String[]>
      [-Credential <PSCredential>]
      [-ConnectionTimeout <Int32>]
      [[-BackupFile] <String[]>]
      [-SqlCredential <PSObject>]
      [-BackupDevice <BackupDeviceItem[]>]
      [-PassThru]
      [-Checksum]
      [-ContinueAfterError]
      [-NoRewind]
      [-Restart]
      [-UnloadTapeAfter]
      [-NoRecovery]
      [-DatabaseFile <String[]>]
      [-DatabaseFileGroup <String[]>]
      [-BlockSize <Int32>]
      [-BufferCount <Int32>]
      [-MaxTransferSize <Int32>]
      [-MediaName <String>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -InputObject <Server[]>
      [[-BackupFile] <String[]>]
      [-SqlCredential <PSObject>]
      [-BackupDevice <BackupDeviceItem[]>]
      [-PassThru]
      [-Checksum]
      [-ContinueAfterError]
      [-NoRewind]
      [-Restart]
      [-UnloadTapeAfter]
      [-NoRecovery]
      [-DatabaseFile <String[]>]
      [-DatabaseFileGroup <String[]>]
      [-BlockSize <Int32>]
      [-BufferCount <Int32>]
      [-MaxTransferSize <Int32>]
      [-MediaName <String>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [[-BackupFile] <String[]>]
      [-SqlCredential <PSObject>]
      [-BackupDevice <BackupDeviceItem[]>]
      [-PassThru]
      [-Checksum]
      [-ContinueAfterError]
      [-NoRewind]
      [-Restart]
      [-UnloadTapeAfter]
      [-NoRecovery]
      [-DatabaseFile <String[]>]
      [-DatabaseFileGroup <String[]>]
      [-BlockSize <Int32>]
      [-BufferCount <Int32>]
      [-MaxTransferSize <Int32>]
      [-MediaName <String>]
      [-Script]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Backup-SqlDatabase führt Sicherungsvorgänge für eine SQL Server-Datenbank aus.

Dazu gehören vollständige Datenbanksicherungen, Transaktionsprotokollsicherungen und Datenbankdateisicherungen.

Dieses Cmdlet wird nach der Microsoft.SqlServer.Management.Smo.Backup-Klasse modelliert.

Die Parameter für diese Klasse entsprechen in der Regel eigenschaften für dieses Smo-Objekt.

Um eine Datenbank nach Serverinstanzpfad und Datenbanknamen zu sichern, geben Sie den Serverinstanzpfad im Parameter "Path" und den Datenbanknamen im Parameter "Database" an.

Um eine Datenbank mithilfe eines Smo.Server-Objekts und eines Datenbanknamens zu sichern, geben Sie das Smo.Server-Objekt im InputObject-Parameter an, entweder direkt oder mithilfe des Pipelineoperators, und den Datenbanknamen im Datenbankparameter.

Um eine Datenbank nach Serverinstanz und Datenbankname zu sichern, geben Sie die Serverinstanz im Parameter "ServerInstance" und den Datenbanknamen im Parameter "Database" an.

Um eine Datenbank mithilfe eines Smo.Database-Objekts zu sichern, geben Sie das Smo.Database-Objekt im Parameter "DatabaseObject" entweder direkt oder mithilfe des Pipelineoperators an.

Standardmäßig führt dieses Cmdlet eine vollständige Datenbanksicherung aus.

Legen Sie den Sicherungstyp mithilfe des BackupAction-Parameters fest.

Standardmäßig wird die Sicherungsdatei im Standardserversicherungsort unter dem Namen databasename.bak für vollständige und/oder Dateisicherungen und unter dem Namen "databasename.trn" für Protokollsicherungen gespeichert. Verwenden Sie den Parameter "BackupFile", um einen anderen Dateinamen anzugeben.

Um einen Speicherort einer Sicherungsdatei anzugeben und einen automatisch generierten Dateinamen zu verwenden, geben Sie den Speicherort mithilfe des BackupContainer-Parameters an.

Beispiele

Beispiel 1: Sichern einer vollständigen Datenbank

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"

Mit diesem Befehl wird eine vollständige Datenbanksicherung der Datenbank mit dem Namen "MainDB" am Standardsicherungsort der Serverinstanz "Computer\Instance" erstellt. Die Sicherungsdatei heißt "MainDB.bak".

Beispiel 2: Sichern einer Datenbank basierend auf dem Standort

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance" 
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"

Mit diesem Befehl wird eine vollständige Datenbanksicherung der Datenbank 'MainDB' am Standardsicherungsort der Serverinstanz 'Computer\Instance' erstellt. Das aktuelle Arbeitsverzeichnis wird verwendet, um die Serverinstanz zu bestimmen, in der die Sicherung erfolgt.

Beispiel 3: Sichern des Transaktionsprotokolls

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log

Mit diesem Befehl wird eine Sicherung des Transaktionsprotokolls der Datenbank 'MainDB' am Standardsicherungsort der Serverinstanz 'Computer\Instance' erstellt. Die Sicherungsdatei heißt "MainDB.trn".

Beispiel 4: Sichern einer Datenbank und Aufforderung zur Eingabe von Anmeldeinformationen

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")

Mit diesem Befehl wird eine vollständige Datenbanksicherung der Datenbank "MainDB" mithilfe der SQL Server-Anmeldung "sa" erstellt. Dieser Befehl fordert ein Kennwort auf, um die Authentifizierung abzuschließen.

Beispiel 5: Sichern einer Datenbank in einer Netzwerkdateifreigabe

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"

Mit diesem Befehl wird eine vollständige Datenbanksicherung der Datenbank 'MainDB' in der Datei "\\mainserver\databasebackup\MainDB.bak" erstellt.

Beispiel 6: Sichern aller Datenbanken in einer Serverinstanz

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase

Mit diesem Befehl werden alle Datenbanken auf der Serverinstanz "Computer\Instance" am Standardsicherungsort gesichert. Die Sicherungsdateien werden <Datenbanknamen>.bak benannt.

Beispiel 7: Sichern aller Datenbanken in einer Serverinstanz in einer Netzwerkdateifreigabe

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance\Databases"
PS SQLSERVER:\SQL\Computer\Instance\Databases> foreach ($database in (Get-ChildItem)) {
     $dbName = $database.Name
     Backup-SqlDatabase -Database $dbName -BackupFile "\\mainserver\databasebackup\$dbName.bak" }

Mit diesem Befehl wird für jede Datenbank auf der Serverinstanz 'Computer\Instance' eine vollständige Sicherung für die Freigabe "\\mainserver\databasebackup" erstellt. Die Sicherungsdateien werden <Datenbanknamen>.bak benannt.

Beispiel 8: Sichern aller Dateien in sekundären Dateigruppen

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"

Mit diesem Befehl wird eine vollständige Dateisicherung jeder Datei in den sekundären Dateigruppen 'FileGroupJan' und 'FileGroupFeb' erstellt.

Beispiel 9: Erstellen einer differenziellen Sicherung

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental

Mit diesem Befehl wird eine differenzielle Sicherung der Datenbank "MainDB" an den Standardsicherungsort der Serverinstanz "Computer\Instance" erstellt. Die Sicherungsdatei heißt "MainDB.bak".

Beispiel 10: Erstellen einer Sicherung auf einem Bandlaufwerk

PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice

Mit diesem Befehl wird eine vollständige Sicherung der Datenbank MainDB auf dem Bandgerät "\\.\tape0" erstellt. Um dieses Gerät darzustellen, erstellt der Befehl eine Instanz des Microsoft.Sqlserver.Management.Smo.BackupDeviceItem-Objekts. Der Konstruktor verwendet zwei Argumente, den Namen des Sicherungsgeräts und den Typ des Sicherungsgeräts. Dieses BackupDeviceItem-Objekt wird an den Parameter BackupDevice des cmdlets Backup-SqlDatabase übergeben.

Beispiel 11: Sichern einer Datenbank im Azure Blob Storage-Dienst

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Mit diesem Befehl wird eine vollständige Sicherung der Datenbank "MainDB" für den Windows Azure Blob Storage-Dienst erstellt. Es verwendet BackupContainer, um den Speicherort (URL) des Windows Azure Blob-Containers anzugeben. Der Name der Sicherungsdatei wird automatisch generiert. Der SqlCredential-Parameter wird verwendet, um den Namen der SQL Server-Anmeldeinformationen anzugeben, die die Authentifizierungsinformationen speichern.

Beispiel 12: Sichern einer Datenbank im Azure Blob Storage-Dienst und Angeben des Dateinamens

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"

Mit diesem Befehl wird eine vollständige Sicherung der Datenbank "MainDB" im Windows Azure Blob Storage-Dienst erstellt. Er verwendet den Parameter BackupFile, um den Speicherort (URL) und den Namen der Sicherungsdatei anzugeben. Der SqlCredential-Parameter wird verwendet, um den Namen der SQL Server-Anmeldeinformationen anzugeben.

Beispiel 13: Sichern aller Datenbanken im Azure Blob Storage-Dienst

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Mit diesem Befehl werden alle Datenbanken auf der Serverinstanz 'Computer\Instance' mithilfe des BackupContainer-Parameters auf dem Windows Azure Blob Storage-Dienstspeicherort gesichert. Die Namen der Sicherungsdatei werden automatisch generiert.

Beispiel 14: Erstellen einer verschlüsselten Sicherung

PS C:\> $EncryptionOption = New-SqlBackupEncryptionOption -Algorithm Aes256 -EncryptorType ServerCertificate -EncryptorName "BackupCert"
PS C:\> Backup-SqlDatabase -ServerInstance "." -Database "MainDB" -BackupFile "MainDB.bak" -CompressionOption On -EncryptionOption $EncryptionOption

In diesem Beispiel werden die Verschlüsselungsoptionen erstellt und als Parameterwert in Backup-SqlDatabase- verwendet, um eine verschlüsselte Sicherung zu erstellen.

Parameter

-AccessToken

Das Zugriffstoken, das zur Authentifizierung bei SQL Server verwendet wird, als Alternative zur Benutzer-/Kennwort- oder Windows-Authentifizierung.

Dies kann z. B. zum Herstellen einer Verbindung mit SQL Azure DB und SQL Azure Managed Instance mithilfe eines Service Principal oder einer Managed Identityverwendet werden.

Der zu verwendende Parameter kann entweder eine Zeichenfolge sein, die das Token darstellt, oder ein PSAccessToken-Objekt, wie durch Ausführen von Get-AzAccessToken -ResourceUrl https://database.windows.netzurückgegeben wird.

Dieser Parameter ist neu in v22 des Moduls.

Typ:	PSObject
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupAction

Gibt den Typ des auszuführenden Sicherungsvorgangs an. Gültige Werte sind:

Datenbank. Sichert alle Datendateien in der Datenbank.
Dateien. Sichert Datendateien, die in den Parametern "DatabaseFile" oder "DatabaseFileGroup" angegeben sind.
Log. Sichert das Transaktionsprotokoll.

Typ:	BackupActionType
Zulässige Werte:	Database, Files, Log
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupContainer

Gibt den Ordner oder Speicherort an, in dem das Cmdlet Sicherungen speichert. Dies kann ein Ordner auf einem Datenträger oder einer URL für einen Azure Blob-Container sein. Dieser Parameter kann nützlich sein, wenn mehrere Datenbanken in einer bestimmten Instanz gesichert werden. Dieser Parameter kann nicht mit einem BackupDevice-Parameter verwendet werden. Der Parameter BackupContainer kann nicht mit dem Parameter BackupFile verwendet werden.

Der Pfad, der zum Angeben der Position verwendet wird, sollte mit einem Schrägstrich (/) enden.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupDevice

Gibt die Geräte an, auf denen die Sicherungen gespeichert werden. Dieser Parameter kann nicht mit dem Parameter BackupFile verwendet werden. Verwenden Sie diesen Parameter, wenn Sie das Band sichern.

Typ:	BackupDeviceItem[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupFile

Gibt den Speicherort und die Dateinamen für die Sicherung an.

Dies ist ein optionaler Parameter.

Wenn nicht angegeben, werden die Sicherungen im Standardsicherungsort des Servers unter dem Namen databasename.bak für vollständige und Dateisicherungen oder databasename.trn für Protokollsicherungen gespeichert.

Trennen Sie beim Sichern mehrerer Dateien die Dateinamen durch Kommas, z. B.: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Dieser Parameter kann nicht mit den Parametern -BackupDevice oder -BackupContainer verwendet werden.

Typ:	String[]
Position:	2
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupSetDescription

Gibt die Beschreibung des Sicherungssatzes an. Dieser Parameter ist optional.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupSetName

Gibt den Namen des Sicherungssatzes an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BlockSize

Gibt die physische Blockgröße für die Sicherung in Byte an. Die unterstützten Größen sind 512, 1024, 2048, 4096, 8192, 16384, 32768 und 65536 (64 KB) Bytes. Der Standardwert ist 65536 für Bandgeräte und 512 für alle anderen Geräte.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BufferCount

Gibt die Anzahl der E/A-Puffer an, die für den Sicherungsvorgang verwendet werden sollen. Sie können eine beliebige positive ganze Zahl angeben. Wenn im Sqlservr.exe Prozess für die Puffer nicht genügend virtueller Adressraum vorhanden ist, wird ein Nichtspeicherfehler angezeigt.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Checksum

Gibt an, dass während des Sicherungsvorgangs ein Prüfsummenwert berechnet wird.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CompressionOption

Gibt die Komprimierungsoptionen für den Sicherungsvorgang an.

Typ:	BackupCompressionOptions
Zulässige Werte:	Default, On, Off
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf. Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ConnectionTimeout

Gibt die Anzahl der Sekunden an, die auf eine Serververbindung warten sollen, bevor ein Timeoutfehler auftritt. Der Timeoutwert muss eine ganze Zahl zwischen 0 und 65534 sein. Wenn 0 angegeben ist, werden Verbindungsversuche nicht timeout ausgeführt.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ContinueAfterError

Gibt an, dass der Vorgang fortgesetzt wird, wenn ein Prüfsummenfehler auftritt. Wenn nicht festgelegt, schlägt der Vorgang nach einem Prüfsummenfehler fehl.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CopyOnly

Gibt an, dass es sich bei der Sicherung um eine kopiegeschützte Sicherung handelt. Eine kopiegeschützte Sicherung wirkt sich nicht auf die normale Abfolge Ihrer regelmäßig geplanten herkömmlichen Sicherungen aus.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Gibt ein PSCredential -Objekt an, das die Anmeldeinformationen für eine SQL Server-Anmeldung enthält, die über die Berechtigung zum Ausführen dieses Vorgangs verfügt. Dies ist nicht das SQL-Anmeldeinformationsobjekt, das zum internen Speichern von Authentifizierungsinformationen durch SQL Server beim Zugriff auf Ressourcen außerhalb von SQL Server verwendet wird.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Database

Gibt den Namen der Datenbank an, die gesichert werden soll. Dieser Parameter kann nicht mit dem Parameter "DatabaseObject" verwendet werden. Wenn dieser Parameter angegeben wird, müssen auch die Parameter Path, InputObject oder ServerInstance angegeben werden.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DatabaseFile

Gibt eine oder mehrere Datenbankdateien an, die gesichert werden sollen. Dieser Parameter wird nur verwendet, wenn BackupAction auf Dateien festgelegt ist. Wenn BackupAction auf "Files" festgelegt ist, muss entweder der Parameter "DatabaseFileGroups" oder "DatabaseFiles" angegeben werden.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DatabaseFileGroup

Gibt die Datenbankdateigruppen an, die vom Sicherungsvorgang gezielt sind. Dieser Parameter wird nur verwendet, wenn die BackupAction-Eigenschaft auf "Files" festgelegt ist. Wenn der Parameter "BackupAction" auf "Files" festgelegt ist, muss entweder der Parameter "DatabaseFileGroups" oder "DatabaseFiles" angegeben werden.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DatabaseObject

Gibt das Datenbankobjekt für den Sicherungsvorgang an.

Typ:	Database
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Encrypt

Der Verschlüsselungstyp, der beim Herstellen einer Verbindung mit SQL Server verwendet werden soll.

Dieser Wert ist der Encrypt Eigenschaft SqlConnectionEncryptOption für das SqlConnection-Objekt des Microsoft.Data.SqlClient-Treibers zugeordnet.

In v22 des Moduls ist die Standardeinstellung Optional (aus Kompatibilität mit v21). In v23+ des Moduls lautet der Standardwert "Verpflichtend", wodurch für vorhandene Skripts eine bahnbrechende Änderung erstellt werden kann.

Dieser Parameter ist neu in v22 des Moduls.

Typ:	String
Zulässige Werte:	Mandatory, Optional, Strict
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionOption

Gibt die Verschlüsselungsoptionen für den Sicherungsvorgang an.

Typ:	BackupEncryptionOptions
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ExpirationDate

Gibt das Datum und die Uhrzeit an, zu dem der Sicherungssatz abläuft, und die Sicherungsdaten werden nicht mehr als gültig betrachtet. Dies kann nur für Sicherungsdaten verwendet werden, die auf Datenträger- oder Bandgeräten gespeichert sind. Sicherungssätze, die älter als das Ablaufdatum sind, können von einer späteren Sicherung überschrieben werden.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FormatMedia

Gibt an, dass das Band als erster Schritt des Sicherungsvorgangs formatiert ist. Dies gilt nicht für eine Datenträgersicherung.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-HostNameInCertificate

Der Hostname, der beim Überprüfen des SQL Server TLS/SSL-Zertifikats verwendet werden soll. Sie müssen diesen Parameter übergeben, wenn Ihre SQL Server-Instanz für die Erzwingungsverschlüsselung aktiviert ist und Sie eine Verbindung mit einer Instanz mit hostname/shortname herstellen möchten. Wenn dieser Parameter nicht angegeben wird, ist das Übergeben des vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) an -ServerInstance erforderlich, um eine Verbindung mit einer SQL Server-Instanz herzustellen, die für die Erzwingungsverschlüsselung aktiviert ist.

Dieser Parameter ist neu in v22 des Moduls.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Incremental

Gibt an, dass eine differenzielle Sicherung ausgeführt wird.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Initialize

Gibt an, dass geräte, die dem Sicherungsvorgang zugeordnet sind, initialisiert werden. Dadurch werden alle vorhandenen Sicherungssätze auf dem Medium überschrieben und diese Sicherung zum ersten Sicherungssatz auf dem Medium.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Gibt das Serverobjekt für den Sicherungsspeicherort an.

Typ:	Server[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-LogTruncationType

Gibt das Abschneidenverhalten für Protokollsicherungen an. Gültige Werte sind:

-- TruncateOnly -- NoTruncate -- Truncate

Der Standardwert ist abgeschnitten.

Typ:	BackupTruncateLogType
Zulässige Werte:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MaxTransferSize

Gibt die maximale Anzahl von Bytes an, die zwischen den Sicherungsmedien und der Instanz von SQL Server übertragen werden sollen. Die möglichen Werte sind Vielfache von 65536 Bytes (64 KB), bis zu 4194304 Bytes (4 MB).

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MediaDescription

Gibt die Beschreibung für das Medium an, das den Sicherungssatz enthält. Dieser Parameter ist optional.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MediaName

Gibt den Namen an, der zum Identifizieren des Mediensatzes verwendet wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MirrorDevices

Gibt ein Array von BackupDeviceList -Objekten an, die von der gespiegelten Sicherung verwendet werden.

Typ:	BackupDeviceList[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NoRecovery

Gibt an, dass das Ende des Protokolls nicht gesichert ist. Wenn die Datenbank wiederhergestellt wird, befindet sich die Datenbank im Wiederherstellungszustand. Wenn sie nicht festgelegt ist, wird das Ende des Protokolls gesichert. Dies gilt nur, wenn der BackupAction-Parameter auf "Log" festgelegt ist.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NoRewind

Gibt an, dass ein Bandlaufwerk an der Endposition geöffnet bleibt, wenn die Sicherung abgeschlossen ist. Wenn sie nicht festgelegt ist, wird das Band nach Abschluss des Vorgangs umwobt. Dies gilt nicht für Datenträger- oder URL-Sicherungen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Gibt an, dass das Cmdlet das Smo.Backup -Objekt ausgibt, das die Sicherung ausgeführt hat.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

Gibt den Pfad zur Instanz von SQL Server an, um den Sicherungsvorgang auszuführen. Dies ist ein optionaler Parameter. Wenn nicht angegeben, wird der Wert dieses Parameters standardmäßig auf den aktuellen Arbeitsspeicherort festgelegt.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:	ActionPreference
Aliase:	proga
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Restart

Gibt an, dass das Cmdlet die Verarbeitung eines teilweise abgeschlossenen Sicherungsvorgangs fortsetzt. Wenn sie nicht festgelegt ist, startet das Cmdlet einen unterbrochenen Sicherungsvorgang am Anfang des Sicherungssatzes neu.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RetainDays

Gibt die Anzahl der Tage an, die verstrichen sein müssen, bevor ein Sicherungssatz überschrieben werden kann. Dies kann nur für Sicherungsdaten verwendet werden, die auf Datenträger- oder Bandgeräten gespeichert sind.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Script

Gibt an, dass dieses Cmdlet ein Transact-SQL Skript ausgibt, das den Sicherungsvorgang ausführt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServerInstance

Gibt den Namen einer SQL Server-Instanz an. Diese Serverinstanz wird zum Ziel des Sicherungsvorgangs.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-SkipTapeHeader

Gibt an, dass der Bandkopf nicht gelesen wird.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SqlCredential

Gibt ein SQL Server-Anmeldeinformationsobjekt an, das Authentifizierungsinformationen speichert. Wenn Sie den BLOB-Speicherdienst sichern, müssen Sie diesen Parameter angeben. Die gespeicherten Authentifizierungsinformationen umfassen den Namen des Speicherkontos und die zugehörigen Zugriffsschlüsselwerte. Geben Sie diesen Parameter nicht für Datenträger oder Band an.

Typ:	PSObject
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StatementTimeout

Legen Sie das Timeout (in Sekunden) für den Sicherungsvorgang fest.

Wenn der Wert 0 oder der StatementTimeout Parameter nicht angegeben ist, wird der Wiederherstellungsvorgang nicht timeout ausgeführt.

Typ:	Int32
Position:	Named
Standardwert:	0
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TrustServerCertificate

Gibt an, ob der Kanal verschlüsselt wird, während die Zertifikatkette umgangen wird, um die Vertrauensstellung zu überprüfen.

In v22 des Moduls ist die Standardeinstellung $true (aus Kompatibilität mit v21). In v23+ des Moduls lautet der Standardwert "$false", wodurch möglicherweise eine änderung für vorhandene Skripts geändert wird.

Dieser Parameter ist neu in v22 des Moduls.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UndoFileName

Gibt den Namen der Rückgängig-Datei an, die verwendet wird, um nicht ausgelassene Transaktionen zu speichern, die während der Wiederherstellung zurückgesetzt werden.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UnloadTapeAfter

Gibt an, dass das Bandgerät nach Abschluss des Vorgangs neu gewounden und entladen wird. Wenn nicht festgelegt, wird kein Versuch unternommen, das Bandmedium zurückzuspulen und zu entladen. Dies gilt nicht für Datenträger- oder URL-Sicherungen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Gibt eine SMO an. Serverobjekt, das auf die Instanz von SQL Server verweist, in der der Sicherungsvorgang ausgeführt wird.

System.String[]

Ausgaben

System.Object

Restore-SqlDatabase

Freigeben über

Backup-SqlDatabase

Syntax

Beschreibung

Beispiele

Beispiel 1: Sichern einer vollständigen Datenbank

Beispiel 2: Sichern einer Datenbank basierend auf dem Standort

Beispiel 3: Sichern des Transaktionsprotokolls

Beispiel 4: Sichern einer Datenbank und Aufforderung zur Eingabe von Anmeldeinformationen

Beispiel 5: Sichern einer Datenbank in einer Netzwerkdateifreigabe

Beispiel 6: Sichern aller Datenbanken in einer Serverinstanz

Beispiel 7: Sichern aller Datenbanken in einer Serverinstanz in einer Netzwerkdateifreigabe

Beispiel 8: Sichern aller Dateien in sekundären Dateigruppen

Beispiel 9: Erstellen einer differenziellen Sicherung

Beispiel 10: Erstellen einer Sicherung auf einem Bandlaufwerk

Beispiel 11: Sichern einer Datenbank im Azure Blob Storage-Dienst

Beispiel 12: Sichern einer Datenbank im Azure Blob Storage-Dienst und Angeben des Dateinamens

Beispiel 13: Sichern aller Datenbanken im Azure Blob Storage-Dienst

Beispiel 14: Erstellen einer verschlüsselten Sicherung

Parameter

-AccessToken

-BackupAction

-BackupContainer

-BackupDevice

-BackupFile

-BackupSetDescription

-BackupSetName

-BlockSize

-BufferCount

-Checksum

-CompressionOption

-Confirm

-ConnectionTimeout

-ContinueAfterError

-CopyOnly

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-EncryptionOption

-ExpirationDate

-FormatMedia

-HostNameInCertificate

-Incremental

-Initialize

-InputObject

-LogTruncationType

-MaxTransferSize

-MediaDescription

-MediaName

-MirrorDevices

-NoRecovery

-NoRewind

-PassThru

-Path

-ProgressAction

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Eingaben

Ausgaben

Ähnliche Themen

Feedback

Feedback

Zusätzliche Ressourcen