Backup-SqlDatabase

Riferimento

Modulo:: SQLServer

Esegue il backup SQL Server oggetti di database.

Sintassi

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>]

Descrizione

Il cmdlet Backup-SqlDatabase esegue le operazioni di backup in un database di SQL Server.

tra cui backup completi del database, backup del log delle transazioni e backup di file di database.

Questo cmdlet è modellato in base alla classe Microsoft.SqlServer.Management.Smo.Backup.

In genere i parametri di questa classe corrispondono alle proprietà di quell'oggetto Smo.

Per eseguire il backup di un database in base al percorso dell'istanza del server e al nome del database, specificare il percorso dell'istanza del server nel parametro Path e il nome del database nel parametro Database.

Per eseguire il backup di un database usando un oggetto Smo.Server e un nome di database, specificare l'oggetto Smo.Server nel parametro InputObject, direttamente o usando l'operatore pipeline e il nome del database nel parametro Database.

Per eseguire il backup di un database in base all'istanza del server e al nome del database, specificare l'istanza del server nel parametro ServerInstance e il nome del database nel parametro Database.

Per eseguire il backup di un database usando un oggetto Smo.Database, specificare l'oggetto Smo.Database nel parametro DatabaseObject, direttamente o usando l'operatore della pipeline.

Per impostazione predefinita, questo cmdlet esegue un backup completo del database.

Impostare il tipo di backup usando il parametro BackupAction.

Per impostazione predefinita, il file di backup viene archiviato nel percorso di backup predefinito del server sotto il nome databasename.bak per i backup completi e/o dei file e sotto il nome databasename.trn per i backup del log. Per specificare un nome di file diverso, usare il parametro BackupFile.

Per specificare un percorso file di backup e usare un nome di file generato automaticamente, specificare il percorso usando il parametro BackupContainer.

Esempio

Esempio 1: Eseguire il backup di un database completo

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

Questo comando crea un backup completo del database denominato 'MainDB' nel percorso di backup predefinito dell'istanza del server 'Computer\Instance'. Il file di backup è denominato 'MainDB.bak'.

Esempio 2: Eseguire il backup di un database in base alla posizione

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

Questo comando crea un backup completo del database 'MainDB' nel percorso di backup predefinito dell'istanza del server 'Computer\Instance'. La directory di lavoro corrente viene usata per determinare l'istanza del server in cui si verifica il backup.

Esempio 3: Eseguire il backup del log delle transazioni

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

Questo comando crea un backup del log delle transazioni del database 'MainDB' nel percorso di backup predefinito dell'istanza del server 'Computer\Instance'. Il file di backup è denominato 'MainDB.trn'.

Esempio 4: Eseguire il backup di un database e richiedere le credenziali

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

Questo comando crea un backup completo del database 'MainDB' usando l'account di accesso 'sa' SQL Server. Questo comando richiede la password per completare l'autenticazione.

Esempio 5: Eseguire il backup di un database in una condivisione file di rete

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

Questo comando crea un backup completo del database 'MainDB' nel file "\mainserver\databasebackup\MainDB.bak".

Esempio 6: Eseguire il backup di tutti i database in un'istanza del server

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

Questo comando esegue il backup di tutti i database dell'istanza del server 'Computer\Istanza' nel percorso di backup predefinito. I file di backup sono denominati <nome> database.bak.

Esempio 7: Eseguire il backup di tutti i database in un'istanza del server in una condivisione file di rete

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" }

Questo comando crea un backup completo per ogni database nell'istanza del server 'Computer\Instance' nella condivisione "\mainserver\databasebackup". I file di backup sono denominati <nome> database.bak.

Esempio 8: Eseguire il backup di tutti i file nei gruppi di file secondari

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

Questo comando crea un backup completo di file di ogni file nei filegroup secondari 'FileGroupJan' e 'FileGroupFeb'.

Esempio 9: Creare un backup differenziale

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

Questo comando crea un backup differenziale del database 'MainDB' nel percorso di backup predefinito dell'istanza del server 'Computer\Instance'. Il file di backup è denominato "MainDB.bak".

Esempio 10: Creare un backup in un'unità nastro

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

Questo comando crea un backup completo del database MainDB nel dispositivo nastro "\.\tape0". Per rappresentare questo dispositivo, il comando costruisce un'istanza dell'oggetto Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Il costruttore accetta due argomenti, il nome del dispositivo di backup e il tipo del dispositivo di backup. Questo oggetto BackupDeviceItem viene passato al parametro BackupDevice del cmdlet Backup-SqlDatabase .

Esempio 11: Eseguire il backup di un database nel servizio Archiviazione BLOB di Azure

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

Questo comando crea un backup completo del database 'MainDB' nel servizio Windows Archiviazione BLOB di Azure. Usa BackupContainer per specificare il percorso (URL) del contenitore BLOB di Windows Azure. Il nome del file di backup viene generato automaticamente. Il parametro SqlCredential viene utilizzato per specificare il nome delle credenziali di SQL Server in cui sono archiviate le informazioni di autenticazione.

Esempio 12: Eseguire il backup di un database nel servizio Archiviazione BLOB di Azure e specificare il nome del file

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

Questo comando crea un backup completo del database MainDB nel servizio Windows Archiviazione BLOB di Azure. Viene utilizzato il parametro BackupFile per specificare il percorso (URL) e il nome del file di backup. Il parametro SqlCredential viene utilizzato per specificare il nome delle credenziali di SQL Server.

Esempio 13: Eseguire il backup di tutti i database nel servizio Archiviazione BLOB di Azure

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

Questo comando esegue il backup di tutti i database nell'istanza del server 'Computer\Istanza' nel percorso del servizio di Windows Archiviazione BLOB di Azure usando il parametro BackupContainer. I nomi dei file di backup vengono generati automaticamente.

Esempio 14: Creare un backup crittografato

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

Questo esempio crea le opzioni di crittografia e lo usa come valore di parametro in Backup-SqlDatabase per creare un backup crittografato.

Parametri

-AccessToken

Token di accesso usato per eseguire l'autenticazione per SQL Server, come alternativa all'autenticazione utente/password o a Windows.

Questa operazione può essere usata, ad esempio, per connettersi a SQL Azure DB e SQL Azure Managed Instance usando un Service Principal oggetto o .Managed Identity

Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net.

Questo parametro è nuovo nella versione 22 del modulo.

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

-BackupAction

Specifica il tipo di operazione di backup da eseguire. I valori validi sono:

Database. Esegue il backup di tutti i file di dati nel database.
File Esegue il backup dei file di dati specificati nei parametri DatabaseFile o DatabaseFileGroup.
Registro. Esegue il backup del log delle transazioni.

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

-BackupContainer

Specifica la cartella o il percorso in cui il cmdlet archivia i backup. Questa può essere una cartella in un disco o un URL per un contenitore BLOB di Azure. Questo parametro può essere utile per il backup di più database in una determinata istanza. Questo parametro non può essere utilizzato con un parametro BackupDevice. Il parametro BackupContainer non può essere utilizzato con il parametro BackupFile.

Il percorso usato per specificare la posizione deve terminare con una barra in avanti (/).

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

-BackupDevice

Specifica i dispositivi in cui vengono archiviati i backup. Questo parametro non può essere utilizzato con il parametro BackupFile. Utilizzare questo parametro per il backup su nastro.

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

-BackupFile

Specifica il percorso e il nome del file del backup. Questo parametro è facoltativo. Se non specificato, i backup vengono archiviati nel percorso di backup predefinito del server sotto il nome databasename.bak per i backup completi e dei file o databasename.trn per i backup del log. Questo parametro non può essere usato con i parametri BackupDevice o BackupContainer.

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

-BackupSetDescription

Specifica la descrizione del set di backup. Questo parametro è facoltativo e,

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

-BackupSetName

Specifica il nome del set di backup.

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

-BlockSize

Specifica le dimensioni del blocco fisico per il backup, in byte. Le dimensioni supportate sono 512, 1024, 2048, 4096, 8192, 16384, 32768 e 65536 (64 KB) byte. Il valore predefinito è 65536 per i dispositivi nastro e 512 per tutti gli altri dispositivi.

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

-BufferCount

Specifica il numero di buffer di I/O da usare per l'operazione di backup. È possibile specificare qualsiasi numero intero positivo. Se nel processo di Sqlservr.exe per i buffer non è disponibile spazio indirizzi virtuali insufficienti, si riceverà un errore di memoria insufficiente.

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

-Checksum

Indica che un valore checksum viene calcolato durante l'operazione di backup.

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

-CompressionOption

Specifica le opzioni di compressione per l'operazione di backup.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet. Richiede la conferma prima di eseguire il cmdlet.

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

-ConnectionTimeout

Specifica il numero di secondi per attendere una connessione server prima di un errore di timeout. Il valore di timeout deve essere un intero compreso tra 0 e 65534. Se viene specificato 0, i tentativi di connessione non eseguono il timeout.

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

-ContinueAfterError

Indica che l'operazione continua quando si verifica un errore checksum. Se non impostato, l'operazione non verrà completata dopo un errore di checksum.

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

-CopyOnly

Indica che il backup è un backup di sola copia. Un backup di sola copia non influisce sulla normale sequenza dei backup convenzionali pianificati regolarmente.

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

-Credential

Specifica un oggetto PSCredential contenente le credenziali per un account di accesso SQL Server che dispone dell'autorizzazione per eseguire questa operazione. Non si tratta dell'oggetto credenziali SQL usato per archiviare le informazioni di autenticazione internamente da SQL Server quando si accedono alle risorse all'esterno dell'SQL Server.

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

-Database

Specifica il nome del database da eseguire il backup. Questo parametro non può essere usato con il parametro DatabaseObject. Quando questo parametro è specificato, è necessario specificare anche i parametri Path, InputObject o ServerInstance.

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

-DatabaseFile

Specifica uno o più file di database da eseguire il backup. Questo parametro viene usato solo quando BackupAction è impostato su File. Quando BackupAction è impostato su File, è necessario specificare il parametro DatabaseFileGroups o DatabaseFiles.

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

-DatabaseFileGroup

Specifica i gruppi di file di database destinati all'operazione di backup. Questo parametro viene usato solo quando la proprietà BackupAction è impostata su Files. Quando il parametro BackupAction è impostato su File, è necessario specificare il parametro DatabaseFileGroups o DatabaseFiles.

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

-DatabaseObject

Specifica l'oggetto di database per l'operazione di backup.

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

-Encrypt

Tipo di crittografia da usare durante la connessione a SQL Server.

Questo valore esegue il Encrypt mapping alla proprietà SqlConnectionEncryptOption nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

Nella versione 22 del modulo il valore predefinito è Optional (per la compatibilità con v21). Nella versione 23+ del modulo il valore predefinito sarà "Obbligatorio", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

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

-EncryptionOption

Specifica le opzioni di crittografia per l'operazione di backup.

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

-ExpirationDate

Specifica la data e l'ora in cui il set di backup scade e i dati di backup non sono più considerati validi. Questa operazione può essere usata solo per i dati di backup archiviati su disco o su nastro. I set di backup precedenti alla data di scadenza sono disponibili per essere sovrascritti da un backup successivo.

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

-FormatMedia

Indica che il nastro viene formattato come primo passaggio dell'operazione di backup. Questa operazione non si applica a un backup del disco.

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

-HostNameInCertificate

Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Force Encryption e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Force Encryption.

Questo parametro è nuovo nella versione 22 del modulo.

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

-Incremental

Indica che viene eseguito un backup differenziale.

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

-Initialize

Indica che i dispositivi associati all'operazione di backup vengono inizializzati. In questo modo vengono sovrascritti i set di backup esistenti nel supporto e viene eseguito il backup del primo set di backup nel supporto.

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

-InputObject

Specifica l'oggetto server per il percorso di backup.

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

-LogTruncationType

Specifica il comportamento di troncamento per i backup del log. I valori validi sono:

-- TruncateOnly -- NoTruncate -- Truncate

Il valore predefinito è Truncate.

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

-MaxTransferSize

Specifica il numero massimo di byte da trasferire tra il supporto di backup e l'istanza di SQL Server. I valori possibili sono i multipli di 65536 byte (64 KB) fino a 4194304 byte (4 MB).

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

-MediaDescription

Specifica la descrizione del supporto contenente il set di backup. Questo parametro è facoltativo e,

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

-MediaName

Specifica il nome usato per identificare il set di supporti.

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

-MirrorDevices

Specifica una matrice di oggetti BackupDeviceList utilizzati dal backup con mirroring.

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

-NoRecovery

Indica che la fine finale del log non viene eseguita il backup. Quando viene ripristinato, il database si trova nello stato di ripristino. Se non impostato, viene eseguito il backup della parte finale del log. Questo vale solo quando il parametro BackupAction è impostato su Log.

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

-NoRewind

Indica che un'unità nastro viene lasciata aperta alla posizione finale al completamento del backup. Se non impostato, il nastro viene riavvolto al termine dell'operazione. Questa operazione non si applica ai backup su disco o URL.

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

-PassThru

Indica che il cmdlet restituisce l'oggetto Smo.Backup che ha eseguito il backup.

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

-Path

Specifica il percorso dell'istanza di SQL Server per eseguire l'operazione di backup. Questo parametro è facoltativo. Se non specificato, il valore predefinito di questo parametro sarà il percorso di lavoro corrente.

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

-Restart

Indica che il cmdlet continua a elaborare un'operazione di backup parzialmente completata. In caso contrario, il cmdlet riavvia un'operazione di backup interrotta all'inizio del set di backup.

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

-RetainDays

Specifica il numero di giorni trascorsi prima che un set di backup possa essere sovrascritto. Questa operazione può essere usata solo per i dati di backup archiviati su disco o su nastro.

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

-Script

Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'operazione di backup.

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

-ServerInstance

Specifica il nome di un'istanza di SQL Server. Questa istanza del server diventa la destinazione dell'operazione di backup.

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

-SkipTapeHeader

Indica che l'intestazione del nastro non è in lettura.

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

-SqlCredential

Specifica un oggetto credenziale SQL Server che archivia le informazioni di autenticazione. Se si esegue il backup del servizio di archiviazione BLOB, è necessario specificare questo parametro. Le informazioni di autenticazione archiviate includono il nome dell'account di archiviazione e i valori delle chiavi di accesso associati. Non specificare questo parametro per disco o nastro.

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

-StatementTimeout

Impostare il timeout (in secondi) per l'operazione di backup.

Se il valore è 0 o il parametro StatementTimeout non è specificato, l'operazione di ripristino non verrà eseguita in timeout.

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

-TrustServerCertificate

Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.

Nella versione 22 del modulo il valore predefinito è $true (per la compatibilità con v21). Nella versione 23+ del modulo il valore predefinito sarà "$false", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

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

-UndoFileName

Specifica il nome del file di annullamento usato per archiviare le transazioni non inviate che vengono eseguito il rollback durante il ripristino.

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

-UnloadTapeAfter

Indica che il dispositivo nastro viene riavvolto e scaricato al termine dell'operazione. Se non impostato, non viene eseguito alcun tentativo di riavvolgimento e scaricamento del supporto a nastro. Questa operazione non si applica ai backup su disco o URL.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito. Mostra cosa succede se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

Input

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Specifica un SMO. Oggetto server che fa riferimento all'istanza di SQL Server in cui si verifica l'operazione di backup.

System.String[]

Output

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Sintassi

Descrizione

Esempio

Esempio 1: Eseguire il backup di un database completo

Esempio 2: Eseguire il backup di un database in base alla posizione

Esempio 3: Eseguire il backup del log delle transazioni

Esempio 4: Eseguire il backup di un database e richiedere le credenziali

Esempio 5: Eseguire il backup di un database in una condivisione file di rete

Esempio 6: Eseguire il backup di tutti i database in un'istanza del server

Esempio 7: Eseguire il backup di tutti i database in un'istanza del server in una condivisione file di rete

Esempio 8: Eseguire il backup di tutti i file nei gruppi di file secondari

Esempio 9: Creare un backup differenziale

Esempio 10: Creare un backup in un'unità nastro

Esempio 11: Eseguire il backup di un database nel servizio Archiviazione BLOB di Azure

Esempio 12: Eseguire il backup di un database nel servizio Archiviazione BLOB di Azure e specificare il nome del file

Esempio 13: Eseguire il backup di tutti i database nel servizio Archiviazione BLOB di Azure

Esempio 14: Creare un backup crittografato

Parametri

-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

Input

Output

Collegamenti correlati

Risorse aggiuntive