Backup-SqlDatabase

Riferimento

Modulo:: SQLServer

Esegue il backup di oggetti di database di SQL Server.

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

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

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

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

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

Descrizione

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

Sono inclusi backup completi del database, backup del log delle transazioni e backup dei file di database.

Questo cmdlet viene modellato dopo la classe Microsoft.SqlServer.Management.Smo.Backup.

I parametri di questa classe corrispondono in genere alle proprietà dell'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 utilizzando 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 utilizzando un oggetto Smo.Database, specificare l'oggetto Smo.Database nel parametro DatabaseObject, direttamente o tramite l'operatore 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 del server predefinito con 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 del file di backup e usare un nome 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\Istanza'. 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 utilizzata per determinare l'istanza del server in cui viene eseguito 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\Istanza'. 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 di SQL Server 'sa'. Questo comando richiede una 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 nell'istanza del server 'Computer\Instance' nel percorso di backup predefinito. I file di backup sono denominati <nome del 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\Istanza' nella condivisione "\\mainserver\databasebackup". I file di backup sono denominati <nome del 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 dei 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 di archiviazione BLOB di Windows 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 usato per specificare il nome delle credenziali di SQL Server che archivia le informazioni di autenticazione.

Esempio 12: Eseguire il backup di un database nel servizio Archiviazione BLOB di Azure e specificare il nome 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 archiviazione BLOB di Windows Azure. Usa il parametro BackupFile per specificare il percorso (URL) e il nome del file di backup. Il parametro SqlCredential viene usato 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 archiviazione BLOB di Windows 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 la usa come valore del parametro in Backup-SqlDatabase per creare un backup crittografato.

Parametri

-AccessToken

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

Può essere usato, ad esempio, per connettersi a SQL Azure DB e SQL Azure Managed Instance usando un Service Principal o un Managed Identity.

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

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:	PSObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupAction

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

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

Tipo:	BackupActionType
Valori accettati:	Database, Files, Log
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupContainer

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

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupDevice

Specifica i dispositivi in cui vengono archiviati i backup. Questo parametro non può essere usato con il parametro BackupFile. Utilizzare questo parametro se si esegue il backup su nastro.

Tipo:	BackupDeviceItem[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupFile

Specifica il percorso e i nomi file per il backup.

Si tratta di un parametro facoltativo.

Se non specificato, i backup vengono archiviati nel percorso di backup predefinito del server con il nome databasename.bak per i backup completi e dei file o databasename.trn per i backup del log.

Quando si esegue il backup in più file, separare i nomi file con virgole, ad esempio: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Questo parametro non può essere usato con i parametri -BackupDevice o -BackupContainer.

Tipo:	String[]
Posizione:	2
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupSetDescription

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupSetName

Specifica il nome del set di backup.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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). Il valore predefinito è 65536 per i dispositivi nastro e 512 per tutti gli altri dispositivi.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BufferCount

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Checksum

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CompressionOption

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

Tipo:	BackupCompressionOptions
Valori accettati:	Default, On, Off
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

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

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionTimeout

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ContinueAfterError

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

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

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Database

Specifica il nome del database di cui eseguire il backup. Questo parametro non può essere utilizzato con il parametro DatabaseObject. Quando si specifica questo parametro, è necessario specificare anche i parametri Path, InputObject o ServerInstance.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DatabaseFile

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DatabaseFileGroup

Specifica i filegroup di database di destinazione dell'operazione di backup. Questo parametro viene usato solo quando la proprietà BackupAction è impostata su Files. Quando il parametro BackupAction è impostato su Files, è necessario specificare il parametro DatabaseFileGroups o DatabaseFiles.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DatabaseObject

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

Tipo:	Database
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Encrypt

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

Questo valore esegue il mapping alla proprietà EncryptSqlConnectionEncryptOption sull'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

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

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:	String
Valori accettati:	Mandatory, Optional, Strict
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionOption

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

Tipo:	BackupEncryptionOptions
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExpirationDate

Specifica la data e l'ora di scadenza del set di backup 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.

Tipo:	DateTime
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FormatMedia

Indica che il nastro è formattato come primo passaggio dell'operazione di backup. Ciò non si applica a un backup su disco.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-HostNameInCertificate

Nome host da usare per convalidare il certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia 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 Forza crittografia.

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Incremental

Indica che viene eseguito un backup differenziale.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Initialize

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Specifica l'oggetto server per il percorso di backup.

Tipo:	Server[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Truncate

Il valore predefinito è Truncate.

Tipo:	BackupTruncateLogType
Valori accettati:	TruncateOnly, NoTruncate, Truncate
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 multipli di 65536 byte (64 KB), fino a 4194304 byte (4 MB).

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MediaDescription

Specifica la descrizione del supporto che contiene il set di backup. Questo parametro è facoltativo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MediaName

Specifica il nome utilizzato per identificare il set di supporti.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MirrorDevices

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

Tipo:	BackupDeviceList[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NoRecovery

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NoRewind

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PassThru

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Path

Specifica il percorso dell'istanza di SQL Server per eseguire l'operazione di backup. Si tratta di un parametro facoltativo. Se non specificato, il valore di questo parametro viene impostato per impostazione predefinita sulla posizione di lavoro corrente.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:	ActionPreference
Alias:	proga
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Restart

Indica che il cmdlet continua a elaborare un'operazione di backup parzialmente completata. Se non impostato, il cmdlet riavvia un'operazione di backup interrotta all'inizio del set di backup.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RetainDays

Specifica il numero di giorni che devono trascorrere 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.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Script

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServerInstance

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-SkipTapeHeader

Indica che l'intestazione del nastro non è letta.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SqlCredential

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

Tipo:	PSObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-StatementTimeout

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

Se il valore è 0 o il parametro StatementTimeout non viene specificato, l'operazione di ripristino non andrà a timeout.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	0
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 compatibilità con v21). Nella versione 23+ del modulo, il valore predefinito sarà "$false", che potrebbe creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UndoFileName

Specifica il nome del file di annullamento utilizzato per archiviare le transazioni di cui non è stato eseguito il commit durante il ripristino.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UnloadTapeAfter

Indica che il dispositivo nastro viene riattivato e scaricato al termine dell'operazione. Se non è impostato, non viene effettuato alcun tentativo di riavvolgimento e scaricamento del supporto nastro. Ciò non si applica ai backup su disco o URL.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito. Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Specifica un valore 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

Condividi tramite

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

-ProgressAction

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Input

Output

Collegamenti correlati

Commenti e suggerimenti

Risorse aggiuntive