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