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>]
      [-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>]
      [-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>]
      [-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>]
      [-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>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

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

Dies umfasst vollständige Datenbanksicherungen sowie Sicherungen des Transaktionsprotokolls und der Datenbankdatei.

Dieses Cmdlet ist der Microsoft.SqlServer.Management.Smo.Backup-Klasse nachgebildet.

Die Parameter für diese Klasse entsprechen im Allgemeinen den Eigenschaften für dieses SMO-Objekt.

Um eine Datenbank nach Server instance Pfad und Datenbanknamen zu sichern, geben Sie den Server instance Pfad im Path-Parameter und den Datenbanknamen im Database-Parameter an.

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

Um eine Datenbank nach Server instance und Datenbanknamen zu sichern, geben Sie den server-instance im ServerInstance-Parameter und den Datenbanknamen im Database-Parameter an.

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

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

Legen Sie den Sicherungstyp mit dem Parameter BackupAction fest.

Standardmäßig wird die Sicherungsdatei im Standardspeicherort des Servers 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 der Sicherungsdatei anzugeben und einen automatisch generierten Dateinamen zu verwenden, geben Sie den Speicherort mithilfe des Parameters BackupContainer an.

Beispiele

Beispiel 1: Sichern einer vollständigen Datenbank

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

Dieser Befehl erstellt eine vollständige Datenbanksicherung der Datenbank mit dem Namen "MainDB" am Standardspeicherort des Servers instance "Computer\Instance". Die Sicherungsdatei heißt "MainDB.bak".

Beispiel 2: Sichern einer Datenbank anhand des Standorts

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 Standardspeicherort des Servers instance "Computer\Instance" erstellt. Das aktuelle Arbeitsverzeichnis wird verwendet, um den Server instance zu bestimmen, an dem 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 Standardspeicherort des Servers instance "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 "sa"-SQL Server Anmeldung erstellt. Dieser Befehl fordert ein Kennwort ein, 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 einem Server instance

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

Durch diesen Befehl werden alle Datenbanken auf der Serverinstanz "Computer\Instance" am standardmäßigen Sicherungsspeicherort gesichert. Die Sicherungsdateien haben den Namen <Datenbankname>.bak.

Beispiel 7: Sichern aller Datenbanken in einem Server instance mit 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" }

Dieser Befehl erstellt eine vollständige Sicherung für jede Datenbank auf dem Server instance "Computer\Instance" zur Freigabe "\\mainserver\databasebackup". Die Sicherungsdateien haben den Namen <Datenbankname>.bak.

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

Dieser Befehl erstellt eine differenzielle Sicherung der Datenbank "MainDB" am Standardspeicherort des Servers instance "Computer\Instance". 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 instance des Microsoft.Sqlserver.Management.Smo.BackupDeviceItem-Objekts. Der Konstruktor akzeptiert 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-Blobcontainers anzugeben. Der Name der Sicherungsdatei wird automatisch generiert. Mit dem SqlCredential-Parameter wird der Name der SQL Server-Anmeldeinformationen angegeben, in denen die Authentifizierungsinformationen gespeichert sind.

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 für den Windows-Azure Blob Storage-Dienst erstellt. Dabei wird der BackupFile-Parameter verwendet, um den Speicherort (URL) und den Namen der Sicherungsdatei anzugeben. Mit dem SqlCredential-Parameter wird der Name der SQL Server-Anmeldeinformationen angegeben.

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 dem Server instance "Computer\Instance" mit dem Windows-Azure Blob Storage-Dienstspeicherort gesichert, indem der BackupContainer-Parameter verwendet wird. Die Sicherungsdateinamen 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. verwendet werden, um eine Verbindung mit SQL Azure DB und SQL Azure Managed Instance mithilfe Service Principal von herzustellen Managed Identity.

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

Dieser Parameter ist neu in v22 des Moduls.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupAction

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

Datenbank. Sichert sämtliche Datendateien in der Datenbank.
Dateien. Sichert Datendateien, die im Parameter DatabaseFile oder DatabaseFileGroup angegeben sind.
Protokoll. Sichert das Transaktionsprotokoll.

Type:	BackupActionType
Accepted values:	Database, Files, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupContainer

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

Gibt die Geräte an, auf denen die Sicherungen gespeichert werden. Dieser Parameter kann nicht mit dem BackupFile-Parameter verwendet werden. Verwenden Sie diesen Parameter für Bandsicherungen.

Type:	BackupDeviceItem[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupFile

Gibt den Speicherort und den Dateinamen der Sicherung an. Dies ist ein optionaler Parameter. Falls nicht angegeben, werden die Sicherungen am Standardspeicherort des Servers unter dem Namen databasename.bak für vollständige Sicherungen und Dateisicherungen oder databasename.trn für Protokollsicherungen gespeichert. Dieser Parameter kann nicht mit den Parametern BackupDevice oder BackupContainer verwendet werden.

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetDescription

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetName

Gibt den Namen des Sicherungssatzes an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, erhalten Sie einen Fehler mit fehlendem Arbeitsspeicher.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Checksum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompressionOption

Gibt die Komprimierungsoptionen für den Sicherungsvorgang an.

Type:	BackupCompressionOptions
Accepted values:	Default, On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen. Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Gibt die Anzahl der Sekunden an, die vor einem Timeoutfehler auf eine Serververbindung gewartet werden müssen. Der Timeoutwert muss einer ganzen Zahl zwischen 0 und 65534 entsprechen. Wenn 0 angegeben ist, führen Verbindungsversuche kein Timeout.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueAfterError

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 verwendet wird, indem SQL Server beim Zugriff auf Ressourcen außerhalb SQL Server.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFile

Gibt eine oder mehrere zu sichernde Datenbankdateien an. Dieser Parameter wird nur verwendet, wenn BackupAction auf Files festgelegt ist. Wenn BackupAction auf Files festgelegt ist, muss entweder der Parameter DatabaseFileGroups oder DatabaseFiles angegeben werden.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFileGroup

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseObject

Gibt das Datenbankobjekt für den Sicherungsvorgang an.

Type:	Database
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

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

Dieser Wert wird der Encrypt -Eigenschaft SqlConnectionEncryptOption des SqlConnection-Objekts des Microsoft.Data.SqlClient-Treibers zugeordnet.

In v22 des Moduls ist Optional der Standardwert (aus Kompatibilität mit v21). In Version 23 und höher des Moduls lautet der Standardwert "Obligatorisch", was zu einer Breaking Change für vorhandene Skripts führen kann.

Dieser Parameter ist in v22 des Moduls neu.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionOption

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

Type:	BackupEncryptionOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpirationDate

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FormatMedia

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Sie müssen diesen Parameter übergeben, wenn Ihr SQL Server instance für "Verschlüsselung erzwingen" aktiviert ist und Sie eine Verbindung mit einem instance mithilfe des Hostnamens/Kurznamens herstellen möchten. Wenn dieser Parameter ausgelassen wird, ist die Übergabe des vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) an -ServerInstance erforderlich, um eine Verbindung mit einem für die Verschlüsselung erzwingen aktivierten SQL Server instance herzustellen.

Dieser Parameter ist in v22 des Moduls neu.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Incremental

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 wird zum ersten Sicherungssatz auf dem Medium.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Gibt das Serverobjekt für den Sicherungsspeicherort an.

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Truncate

Der Standardwert ist Abschneiden.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxTransferSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaDescription

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MirrorDevices

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

Type:	BackupDeviceList[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRecovery

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRewind

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Gibt den Pfad zum instance von SQL Server an, um den Sicherungsvorgang auszuführen. Dies ist ein optionaler Parameter. Wird dieser Parameter nicht angegeben, wird der Wert standardmäßig auf den aktuellen Arbeitsstandort festgelegt.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetainDays

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

Gibt den Namen eines SQL Server instance an. Diese Serverinstanz wird zum Ziel des Sicherungsvorgangs.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SkipTapeHeader

Gibt an, dass der Bandheader nicht gelesen wird.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SqlCredential

Gibt ein SQL Server Anmeldeinformationsobjekt an, das Authentifizierungsinformationen speichert. Wenn Sie eine Sicherung im Blob Storage-Dienst ausführen, 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.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StatementTimeout

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

Wenn der Wert 0 ist oder der Parameter StatementTimeout nicht angegeben ist, wird für den Wiederherstellungsvorgang kein Timeout ausgeführt.

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

Gibt an, ob der Kanal verschlüsselt wird, während das Durchlaufen der Zertifikatkette zum Überprüfen der Vertrauensstellung umgangen wird.

In v22 des Moduls ist $true der Standardwert (aus Kompatibilität mit v21). In Version 23 und höher des Moduls lautet der Standardwert "$false", was zu einer Breaking Change für vorhandene Skripts führen kann.

Dieser Parameter ist in v22 des Moduls neu.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UndoFileName

Gibt den Namen der Rückgängig-Datei an, die zum Speichern von Transaktionen ohne Commit verwendet wird, die während der Wiederherstellung zurückgesetzt werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnloadTapeAfter

Gibt an, dass das Bandgerät nach Abschluss des Vorgangs umgewickelt 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt an, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

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

System.String[]

Ausgaben

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Syntax

Beschreibung

Beispiele

Beispiel 1: Sichern einer vollständigen Datenbank

Beispiel 2: Sichern einer Datenbank anhand des Standorts

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 einem Server instance

Beispiel 7: Sichern aller Datenbanken in einem Server instance mit 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

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Eingaben

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen