Freigeben über


Backup-SqlDatabase

Sichert SQL Server-Datenbankobjekte.

Syntax

ByPath (Standardwert)

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-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>]
    [-Path <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>]

ByDBObject

Backup-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-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>]
    [-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>]

ByName

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-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>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-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>]

ByObject

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-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>]
    [-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>]

ByBackupContainer

Backup-SqlDatabase
    [[-BackupFile] <String[]>]
    [-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>]
    [-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 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 sind der Name der <Datenbank>.bak.

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 sind der Name der <Datenbank>.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

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. verwendet werden, um eine Verbindung mit SQL Azure DB einer SQL Azure Managed Instance oder einer Service PrincipalManaged 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.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:BackupActionType
Standardwert:None
Zulässige Werte:Database, Files, Log
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

BackupDeviceItem[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 -BackupDevice Parametern verwendet -BackupContainer werden.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BackupSetDescription

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BackupSetName

Gibt den Namen des Sicherungssatzes an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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, 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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Checksum

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CompressionOption

Gibt die Komprimierungsoptionen für den Sicherungsvorgang an.

Parametereigenschaften

Typ:BackupCompressionOptions
Standardwert:None
Zulässige Werte:Default, On, Off
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByName
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByName
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByPath
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByName
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByObject
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DatabaseObject

Gibt das Datenbankobjekt für den Sicherungsvorgang an.

Parametereigenschaften

Typ:Database
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByDBObject
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 Optional der Standardwert (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.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Mandatory, Optional, Strict
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EncryptionOption

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

Parametereigenschaften

Typ:BackupEncryptionOptions
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FormatMedia

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Incremental

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt das Serverobjekt für den Sicherungsspeicherort an.

Parametereigenschaften

Typ:

Server[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByObject
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Truncate

Der Standardwert ist abgeschnitten.

Parametereigenschaften

Typ:BackupTruncateLogType
Standardwert:None
Zulässige Werte:TruncateOnly, NoTruncate, Truncate
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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).

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MediaDescription

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MediaName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MirrorDevices

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

Parametereigenschaften

Typ:

BackupDeviceList[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Gibt den Pfad zur Instanz 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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByPath
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Script

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerInstance

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByName
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SkipTapeHeader

Gibt an, dass der Bandkopf nicht gelesen wird.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 der Wiederherstellungsvorgang nicht zum Timeout wechseln.

Parametereigenschaften

Typ:Int32
Standardwert:0
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 $true der Standardwert (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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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