functions/Backup-DbaDatabase.ps1
|
function Backup-DbaDatabase { <# .SYNOPSIS Backup one or more SQL Sever databases from a single SQL Server SqlInstance. .DESCRIPTION Performs a backup of a specified type of 1 or more databases on a single SQL Server Instance. These backups may be Full, Differential or Transaction log backups. .PARAMETER SqlInstance The SQL Server instance hosting the databases to be backed up. .PARAMETER SqlCredential Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential). Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported. For MFA support, please use Connect-DbaInstance. .PARAMETER Database The database(s) to process. This list is auto-populated from the server. If unspecified, all databases will be processed. .PARAMETER ExcludeDatabase The database(s) to exclude. This list is auto-populated from the server. .PARAMETER FilePath The name of the file to backup to. This is only accepted for single database backups. If no name is specified then the backup files will be named DatabaseName_yyyyMMddHHmm (i.e. "Database1_201714022131") with the appropriate extension. If the same name is used repeatedly, SQL Server will add backups to the same file at an incrementing position. SQL Server needs permissions to write to the specified location. Path names are based on the SQL Server (C:\ is the C drive on the SQL Server, not the machine running the script). Passing in NUL as the FilePath will backup to the NUL: device .PARAMETER IncrementPrefix If enables, this will prefix backup files with an incrementing integer (ie; '1-', '2-'). Using this has been alleged to improved restore times on some Azure based SQL Database platorms .PARAMETER TimeStampFormat By default the command timestamps backups using the format yyyyMMddHHmm. Using this parameter this can be overridden. The timestamp format should be defined using the Get-Date formats, illegal formats will cause an error to be thrown .PARAMETER Path Path in which to place the backup files. If not specified, the backups will be placed in the default backup location for SqlInstance. If multiple paths are specified, the backups will be striped across these locations. This will overwrite the FileCount option. If the path does not exist, Sql Server will attempt to create it. Folders are created by the Sql Instance, and checks will be made for write permissions. File Names with be suffixed with x-of-y to enable identifying striped sets, where y is the number of files in the set and x ranges from 1 to y. .PARAMETER ReplaceInName If this switch is set, the following list of strings will be replaced in the FilePath and Path strings: instancename - will be replaced with the instance Name servername - will be replaced with the server name dbname - will be replaced with the database name timestamp - will be replaced with the timestamp (either the default, or the format provided) backuptype - will be replaced with Full, Log or Differential as appropriate .PARAMETER CopyOnly If this switch is enabled, CopyOnly backups will be taken. By default function performs a normal backup, these backups interfere with the restore chain of the database. CopyOnly backups will not interfere with the restore chain of the database. For more details please refer to this MSDN article - https://msdn.microsoft.com/en-us/library/ms191495.aspx .PARAMETER Type The type of SQL Server backup to perform. Accepted values are "Full", "Log", "Differential", "Diff", "Database" .PARAMETER FileCount This is the number of striped copies of the backups you wish to create. This value is overwritten if you specify multiple Backup Directories. .PARAMETER CreateFolder If this switch is enabled, each database will be backed up into a separate folder on each of the paths specified by Path. .PARAMETER CompressBackup If this switch is enabled, the function will try to perform a compressed backup if supported by the version and edition of SQL Server. Otherwise, this function will use the server(s) default setting for compression. .PARAMETER MaxTransferSize Sets the size of the unit of transfer. Values must be a multiple of 64kb. .PARAMETER Blocksize Specifies the block size to use. Must be one of 0.5KB, 1KB, 2KB, 4KB, 8KB, 16KB, 32KB or 64KB. This can be specified in bytes. Refer to https://msdn.microsoft.com/en-us/library/ms178615.aspx for more detail .PARAMETER BufferCount Number of I/O buffers to use to perform the operation. Refer to https://msdn.microsoft.com/en-us/library/ms178615.aspx for more detail .PARAMETER Checksum If this switch is enabled, the backup checksum will be calculated. .PARAMETER Verify If this switch is enabled, the backup will be verified by running a RESTORE VERIFYONLY against the SqlInstance .PARAMETER WithFormat Formats the media as the first step of the backup operation. NOTE: This will set Initialize and SkipTapeHeader to $true. .PARAMETER Initialize Initializes the media as part of the backup operation. .PARAMETER SkipTapeHeader Initializes the media as part of the backup operation. .PARAMETER InputObject Internal parameter .PARAMETER AzureBaseUrl The URL(s) to the base container of an Azure Storage account to write backups to. If specifying the AzureCredential parameter you can only provide 1 value as page blobs do not support multiple URLs If using Shared Access keys, you may specify as many URLs as you want, as long as a corresponding credential exists on the source server. If specified, the only other parameters than can be used are "CopyOnly", "Type", "CompressBackup", "Checksum", "Verify", "AzureCredential", "CreateFolder". .PARAMETER AzureCredential The name of the credential on the SQL instance that can write to the AzureBaseUrl, only needed if using Storage access keys If using SAS credentials, the command will look for a credential with a name matching the AzureBaseUrl. As page blobs are used with this option we force the number of files to 1 and ignore any value passed in for BlockSize or MaxTransferSize .PARAMETER NoRecovery This is passed in to perform a tail log backup if needed .PARAMETER BuildPath By default this command will not attempt to create missing paths, this switch will change the behaviour so that it will .PARAMETER IgnoreFileChecks This switch stops the function from checking for the validity of paths. This can be useful if SQL Server only has read access to the backup area. Note, that as we cannot check the path you may well end up with errors. .PARAMETER OutputScriptOnly Switch causes only the T-SQL script for the backup to be generated. Will not create any paths if they do not exist .PARAMETER EncryptionAlgorithm Specified the Encryption Algorithm to used. Must be one of 'AES128','AES192','AES256' or 'TRIPLEDES' Must specify one of EncryptionCertificate or EncryptionKey as well. .PARAMETER EncryptionCertificate The name of the certificate to be used to encrypt the backups. The existance of the certificate will be checked, and will not proceed if it does not exist Is mutually exclusive with the EncryptionKey option .PARAMETER EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch. .PARAMETER WhatIf If this switch is enabled, no actions are performed but informational messages will be displayed that explain what would happen if the command were to run. .PARAMETER Confirm If this switch is enabled, you will be prompted for confirmation before executing any operations that change state. .NOTES Tags: DisasterRecovery, Backup, Restore Author: Stuart Moore (@napalmgram), stuart-moore.com Website: https://dbatools.io Copyright: (c) 2018 by dbatools, licensed under MIT License: MIT https://opensource.org/licenses/MIT .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Server1 -Database HR, Finance This will perform a full database backup on the databases HR and Finance on SQL Server Instance Server1 to Server1 default backup directory. .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance sql2016 -Path C:\temp -Database AdventureWorks2014 -Type Full Backs up AdventureWorks2014 to sql2016 C:\temp folder. .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance sql2016 -AzureBaseUrl https://dbatoolsaz.blob.core.windows.net/azbackups/ -AzureCredential dbatoolscred -Type Full -CreateFolder Performs a full backup of all databases on the sql2016 instance to their own containers under the https://dbatoolsaz.blob.core.windows.net/azbackups/ container on Azure blog storage using the sql credential "dbatoolscred" registered on the sql2016 instance. .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance sql2016 -AzureBaseUrl https://dbatoolsaz.blob.core.windows.net/azbackups/ -Type Full Performs a full backup of all databases on the sql2016 instance to the https://dbatoolsaz.blob.core.windows.net/azbackups/ container on Azure blog storage using the Shared Access Signature sql credential "https://dbatoolsaz.blob.core.windows.net/azbackups" registered on the sql2016 instance. .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Server1\Prod -Database db1 -Path \\filestore\backups\servername\instancename\dbname\backuptype -Type Full -ReplaceInName Performs a full backup of db1 into the folder \\filestore\backups\server1\prod\db1 .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Server1\Prod -Path \\filestore\backups\servername\instancename\dbname\backuptype -FilePath dbname-backuptype-timestamp.trn -Type Log -ReplaceInName Performs a log backup for every database. For the database db1 this would results in backup files in \\filestore\backups\server1\prod\db1\Log\db1-log-31102018.trn .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Sql2017 -Database master -FilePath NUL Performs a backup of master, but sends the output to the NUL device (ie; throws it away) .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Sql2016 -Database stripetest -AzureBaseUrl https://az.blob.core.windows.net/sql,https://dbatools.blob.core.windows.net/sql Performs a backup of the database stripetest, striping it across the 2 Azure blob containers at https://az.blob.core.windows.net/sql and https://dbatools.blob.core.windows.net/sql, assuming that Shared Access Signature credentials for both containers exist on the source instance .EXAMPLE PS C:\> Backup-DbaDatabase -SqlInstance Sql2017 -Database master -EncryptionAlgorithm AES256 -EncryptionCertificate BackupCert Backs up the master database using the BackupCert certificate and the AES256 algorithm. #> [CmdletBinding(DefaultParameterSetName = "Default", SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingPlainTextForPassword", "")] #For AzureCredential param ( [parameter(ParameterSetName = "Pipe", Mandatory)] [DbaInstanceParameter]$SqlInstance, [PSCredential]$SqlCredential, [object[]]$Database, [object[]]$ExcludeDatabase, [Alias('BackupDirectory')] [string[]]$Path, [Alias('BackupFileName')] [string]$FilePath, [switch]$IncrementPrefix, [switch]$ReplaceInName, [switch]$CopyOnly, [ValidateSet('Full', 'Log', 'Differential', 'Diff', 'Database')] [string]$Type = 'Database', [parameter(ParameterSetName = "NoPipe", Mandatory, ValueFromPipeline)] [object[]]$InputObject, [switch]$CreateFolder, [int]$FileCount = 0, [switch]$CompressBackup, [switch]$Checksum, [switch]$Verify, [int]$MaxTransferSize, [int]$BlockSize, [int]$BufferCount, [string[]]$AzureBaseUrl, [string]$AzureCredential, [switch]$NoRecovery, [switch]$BuildPath, [switch]$WithFormat, [switch]$Initialize, [switch]$SkipTapeHeader, [string]$TimeStampFormat, [switch]$IgnoreFileChecks, [switch]$OutputScriptOnly, [ValidateSet('AES128', 'AES192', 'AES256', 'TRIPLEDES')] [String]$EncryptionAlgorithm, [String]$EncryptionCertificate, [switch]$EnableException ) begin { # This is here ready to go when get EKM working so we can do encrption with asymmetric encryption. $EncryptionKey = $null if (-not (Test-Bound 'TimeStampFormat')) { Write-Message -Message 'Setting Default timestampformat' -Level Verbose $TimeStampFormat = "yyyyMMddHHmm" } if ((Test-Bound 'AzureBaseUrl') -and (Test-Bound 'CreateFolder')) { Stop-Function -Message 'CreateFolder cannot be specified with an Azure Backup, the container must exist and be referenced by the URL' return } if ((Test-Bound 'AzureCredential') -and (Test-Bound 'BlockSize')) { Write-Message -Level Warning -Message 'BlockSize cannot be specified when backup up to an Azure page blob, ignoring' $BlockSize = $null } if ((Test-Bound 'AzureCredential') -and (Test-Bound 'MaxTransferSize')) { Write-Message -Level Warning -Message 'MaxTransferSize cannot be specified when backup up to an Azure page blob ignoring' $MaxTransferSize = $null } if ($SqlInstance) { try { $Server = Connect-SqlInstance -SqlInstance $SqlInstance -SqlCredential $SqlCredential -AzureUnsupported } catch { Stop-Function -Message "Cannot connect to $SqlInstance" -ErrorRecord $_ return } $InputObject = $server.Databases | Where-Object Name -ne 'tempdb' if ($Database) { $InputObject = $InputObject | Where-Object Name -in $Database } if ($ExcludeDatabase) { $InputObject = $InputObject | Where-Object Name -notin $ExcludeDatabase } if ( (Test-Bound AzureBaseUrl -Not) -and (Test-Bound Path -Not) -and $FilePath -ne 'NUL') { Write-Message -Message 'No backup folder passed in, setting it to instance default' -Level Verbose $Path = (Get-DbaDefaultPath -SqlInstance $server).Backup } if ($Path.Count -gt 1) { Write-Message -Level Verbose -Message "Multiple Backup Directories, striping" $FileCount = $Path.Count } if ($InputObject.Count -gt 1 -and $FilePath -ne '' -and $True -ne $ReplaceInFile) { Stop-Function -Message "1 BackupFile specified, but more than 1 database." return } if (($MaxTransferSize % 64kb) -ne 0 -or $MaxTransferSize -gt 4mb) { Stop-Function -Message "MaxTransferSize value must be a multiple of 64kb and no greater than 4MB" return } if ($BlockSize) { if ($BlockSize -notin (0.5kb, 1kb, 2kb, 4kb, 8kb, 16kb, 32kb, 64kb)) { Stop-Function -Message "Block size must be one of 0.5kb,1kb,2kb,4kb,8kb,16kb,32kb,64kb" return } } if ($null -ne $AzureBaseUrl) { $AzureBaseUrl = $AzureBaseUrl.Trim("/") if ('' -ne $AzureCredential) { Write-Message -Message "Azure Credential name passed in, will proceed assuming it's value" -Level Verbose $FileCount = 1 } else { foreach ($baseUrl in $AzureBaseUrl) { $base = $baseUrl -split "/" if ( $base.Count -gt 4) { Write-Message "AzureURL contains a folder" $credentialName = $base[0] + "//" + $base[2] + "/" + $base[3] } Write-Message -Message "AzureUrl and no credential, testing for SAS credential" if (Get-DbaCredential -SqlInstance $server -Name $credentialName) { Write-Message -Message "Found a SAS backup credential" -Level Verbose } else { Stop-Function -Message "You must provide the credential name for the Azure Storage Account" return } } } $FileCount = $AzureBaseUrl.count $Path = $AzureBaseUrl } if (Test-Bound 'EncryptionAlgorithm') { if (!((Test-Bound 'EncryptionCertificate') -xor (Test-Bound 'EncryptionKey'))) { Stop-Function -Message 'EncryptionCertifcate and EncryptionKey are mutually exclusive, only provide on of them' return } else { $encryptionOptions = New-Object Microsoft.SqlServer.Management.Smo.BackupEncryptionOptions if (Test-Bound 'EncryptionCertificate') { $tCertCheck = Get-DbaDbCertificate -SqlInstance $server -Database master -Certificate $EncryptionCertificate if ($null -eq $tCertCheck) { Stop-Function -Message "Certificate $EncryptionCertificate does not exist on $server so cannot be used for backups" return } else { $encryptionOptions.encryptorType = [Microsoft.SqlServer.Management.Smo.BackupEncryptorType]::ServerCertificate $encryptionOptions.encryptorName = $EncryptionCertificate $encryptionOptions.Algorithm = [Microsoft.SqlServer.Management.Smo.BackupEncryptionAlgorithm]::$EncryptionAlgorithm } } if (Test-Bound 'EncryptionKey') { # Should not end up here until Key encryption in implemented $tKeyCheck = Get-DbaDbAsymmetricKey -SqlInstance $server -Database master -Name $EncrytptionKey if ($null -eq $tKeyCheck) { Stop-Function -Message "AsymmetricKey $Encryptionkey does not exist on $server so cannot be used for backups" return } else { $encryptionOptions.encryptorType = [Microsoft.SqlServer.Management.Smo.BackupEncryptorType]::ServerAsymmetricKey $encryptionOptions.encryptorName = $EncryptionKey $encryptionOptions.Algorithm = [Microsoft.SqlServer.Management.Smo.BackupEncryptionAlgorithm]::$EncryptionAlgorithm } } } } if ($OutputScriptOnly) { $IgnoreFileChecks = $true } } } process { if (-not $SqlInstance -and -not $InputObject) { Stop-Function -Message "You must specify a server and database or pipe some databases" return } Write-Message -Level Verbose -Message "$($InputObject.Count) database to backup" if ($Database) { $InputObject = $InputObject | Where-Object Name -in $Database } if ($ExcludeDatabase) { $InputObject = $InputObject | Where-Object Name -notin $ExcludeDatabase } if ($InputObject.count -eq 0) { Write-Message -Level Warning -Message "No databases match the request for backups" } foreach ($db in $InputObject) { $ProgressId = Get-Random $failures = @() $dbname = $db.Name $server = $db.Parent if ($null -eq $PSBoundParameters.Path -and $PSBoundParameters.FilePath -ne 'NUL' -and $server.VersionMajor -eq 8) { Write-Message -Message 'No backup folder passed in, setting it to instance default' -Level Verbose $Path = (Get-DbaDefaultPath -SqlInstance $server).Backup } if ($dbname -eq "tempdb") { Stop-Function -Message "Backing up tempdb not supported" -Continue } if ('Normal' -notin ($db.Status -split ',')) { Stop-Function -Message "Database status not Normal. $dbname skipped." -Continue } if ($db.DatabaseSnapshotBaseName) { Stop-Function -Message "Backing up snapshots not supported. $dbname skipped." -Continue } Write-Message -Level Verbose -Message "Backup database $db" if ($null -eq $db.RecoveryModel) { $db.RecoveryModel = $server.Databases[$db.Name].RecoveryModel Write-Message -Level Verbose -Message "$dbname is in $($db.RecoveryModel) recovery model" } # Fixes one-off cases of StackOverflowException crashes, see issue 1481 $dbRecovery = $db.RecoveryModel.ToString() if ($dbRecovery -eq 'Simple' -and $Type -eq 'Log') { $failreason = "$db is in simple recovery mode, cannot take log backup" $failures += $failreason Write-Message -Level Warning -Message "$failreason" } $lastfull = $db.Refresh().LastBackupDate.Year if ($Type -notin @("Database", "Full") -and $lastfull -eq 1) { $failreason = "$db does not have an existing full backup, cannot take log or differentialbackup" $failures += $failreason Write-Message -Level Warning -Message "$failreason" } if ($CopyOnly -ne $true) { $CopyOnly = $false } $server.ConnectionContext.StatementTimeout = 0 $backup = New-Object Microsoft.SqlServer.Management.Smo.Backup $backup.Database = $db.Name $Suffix = "bak" if ($null -ne $encryptionOptions) { $backup.EncryptionOption = $encryptionOptions } if ($CompressBackup) { if ($db.EncryptionEnabled) { Write-Message -Level Warning -Message "$dbname is enabled for encryption, will not compress" $backup.CompressionOption = 2 } elseif ($server.Edition -like 'Express*' -or ($server.VersionMajor -eq 10 -and $server.VersionMinor -eq 0 -and $server.Edition -notlike '*enterprise*') -or $server.VersionMajor -lt 10) { Write-Message -Level Warning -Message "Compression is not supported with this version/edition of Sql Server" } else { Write-Message -Level Verbose -Message "Compression enabled" $backup.CompressionOption = 1 } } if ($Checksum) { $backup.Checksum = $true } if ($Type -in 'Diff', 'Differential') { Write-Message -Level VeryVerbose -Message "Creating differential backup" $SMOBackuptype = "Database" $backup.Incremental = $true $outputType = 'Differential' $gbhSwitch = @{'LastDiff' = $true } } $Backup.NoRecovery = $false if ($Type -eq "Log") { Write-Message -Level VeryVerbose -Message "Creating log backup" $Suffix = "trn" $OutputType = 'Log' $SMOBackupType = 'Log' $Backup.NoRecovery = $NoRecovery $gbhSwitch = @{'LastLog' = $true } } if ($Type -in 'Full', 'Database') { Write-Message -Level VeryVerbose -Message "Creating full backup" $SMOBackupType = "Database" $OutputType = 'Full' $gbhSwitch = @{'LastFull' = $true } } $backup.CopyOnly = $CopyOnly $backup.Action = $SMOBackupType if ($null -ne $AzureBaseUrl -and $null -ne $AzureCredential) { $backup.CredentialName = $AzureCredential } Write-Message -Level Verbose -Message "Building file name" $BackupFinalName = '' $FinalBackupPath = @() $timestamp = Get-Date -Format $TimeStampFormat if ('NUL' -eq $FilePath) { $FinalBackupPath += 'NUL:' $IgnoreFileChecks = $true } elseif ('' -ne $FilePath) { $File = New-Object System.IO.FileInfo($FilePath) $BackupFinalName = $file.Name $suffix = $file.extension -Replace '^\.', '' if ( '' -ne (Split-Path $FilePath)) { Write-Message -Level Verbose -Message "Fully qualified path passed in" $FinalBackupPath += [IO.Path]::GetFullPath($file.DirectoryName) } } else { Write-Message -Level VeryVerbose -Message "Setting filename - $timestamp" $BackupFinalName = "$($dbname)_$timestamp.$suffix" } Write-Message -Level Verbose -Message "Building backup path" if ($FinalBackupPath.Count -eq 0) { $FinalBackupPath += $Path } if ($Path.Count -eq 1 -and $FileCount -gt 1) { for ($i = 0; $i -lt ($FileCount - 1); $i++) { $FinalBackupPath += $FinalBackupPath[0] } } if ($AzureBaseUrl -or $AzureCredential) { $slash = "/" } else { $slash = "\" } if ($FinalBackupPath.Count -gt 1) { $File = New-Object System.IO.FileInfo($BackupFinalName) for ($i = 0; $i -lt $FinalBackupPath.Count; $i++) { $FinalBackupPath[$i] = $FinalBackupPath[$i] + $slash + ("$($i+1)-" * $IncrementPrefix.ToBool() ) + $($File.BaseName) + "-$($i+1)-of-$FileCount.$suffix" } } elseif ($FinalBackupPath[0] -ne 'NUL:') { $FinalBackupPath[0] = $FinalBackupPath[0] + $slash + $BackupFinalName } if ($CreateFolder -and $FinalBackupPath[0] -ne 'NUL:') { for ($i = 0; $i -lt $FinalBackupPath.Count; $i++) { $parent = [IO.Path]::GetDirectoryName($FinalBackupPath[$i]) $leaf = [IO.Path]::GetFileName($FinalBackupPath[$i]) $FinalBackupPath[$i] = [IO.Path]::Combine($parent, $dbname, $leaf) } } if ($True -eq $ReplaceInName) { for ($i = 0; $i -lt $FinalBackupPath.count; $i++) { $FinalBackupPath[$i] = $FinalBackupPath[$i] -replace ('dbname', $dbname) $FinalBackupPath[$i] = $FinalBackupPath[$i] -replace ('instancename', $SqlInstance.InstanceName) $FinalBackupPath[$i] = $FinalBackupPath[$i] -replace ('servername', $SqlInstance.ComputerName) $FinalBackupPath[$i] = $FinalBackupPath[$i] -replace ('timestamp', $timestamp) $FinalBackupPath[$i] = $FinalBackupPath[$i] -replace ('backuptype', $outputType) } } if (-not $IgnoreFileChecks -and -not $AzureBaseUrl) { $parentPaths = ($FinalBackupPath | ForEach-Object { Split-Path $_ } | Select-Object -Unique) foreach ($parentPath in $parentPaths) { if (-not (Test-DbaPath -SqlInstance $server -Path $parentPath)) { if (($BuildPath -eq $true) -or ($CreateFolder -eq $True)) { $null = New-DbaDirectory -SqlInstance $server -Path $parentPath } else { $failreason += "SQL Server cannot check if $parentPath exists. You can try disabling this check with -IgnoreFileChecks" $failures += $failreason Write-Message -Level Warning -Message "$failreason" } } } } if ($null -eq $AzureBaseUrl -and $Path) { $FinalBackupPath = $FinalBackupPath | ForEach-Object { [IO.Path]::GetFullPath($_) } } $script = $null $backupComplete = $false if (!$failures) { $FileCount = $FinalBackupPath.Count foreach ($backupfile in $FinalBackupPath) { $device = New-Object Microsoft.SqlServer.Management.Smo.BackupDeviceItem if ($null -ne $AzureBaseUrl) { $device.DeviceType = "URL" } else { $device.DeviceType = "File" } if ($WithFormat) { Write-Message -Message "WithFormat specified. Ensuring Initialize and SkipTapeHeader are set to true." -Level Verbose $Initialize = $true $SkipTapeHeader = $true } $backup.FormatMedia = $WithFormat $backup.Initialize = $Initialize $backup.SkipTapeHeader = $SkipTapeHeader $device.Name = $backupfile $backup.Devices.Add($device) } $humanBackupFile = $FinalBackupPath -Join ',' Write-Message -Level Verbose -Message "Devices added" $percent = [Microsoft.SqlServer.Management.Smo.PercentCompleteEventHandler] { Write-Progress -id $ProgressId -activity "Backing up database $dbname to $humanBackupFile" -PercentComplete $_.Percent -status ([System.String]::Format("Progress: {0} %", $_.Percent)) } $backup.add_PercentComplete($percent) $backup.PercentCompleteNotification = 1 $backup.add_Complete($complete) if ($MaxTransferSize) { $backup.MaxTransferSize = $MaxTransferSize } if ($BufferCount) { $backup.BufferCount = $BufferCount } if ($BlockSize) { $backup.Blocksize = $BlockSize } Write-Progress -id $ProgressId -activity "Backing up database $dbname to $humanBackupFile" -PercentComplete 0 -status ([System.String]::Format("Progress: {0} %", 0)) try { if ($Pscmdlet.ShouldProcess($server.Name, "Backing up $dbname to $humanBackupFile")) { if ($OutputScriptOnly -ne $True) { $Filelist = @() $FileList += $server.Databases[$dbname].FileGroups.Files | Select-Object @{ Name = "FileType"; Expression = { "D" } }, @{ Name = "Type"; Expression = { "D" } }, @{ Name = "LogicalName"; Expression = { $_.Name } }, @{ Name = "PhysicalName"; Expression = { $_.FileName } } $FileList += $server.Databases[$dbname].LogFiles | Select-Object @{ Name = "FileType"; Expression = { "L" } }, @{ Name = "Type"; Expression = { "L" } }, @{ Name = "LogicalName"; Expression = { $_.Name } }, @{ Name = "PhysicalName"; Expression = { $_.FileName } } $backup.SqlBackup($server) $script = $backup.Script($server) Write-Progress -id $ProgressId -activity "Backing up database $dbname to $backupfile" -status "Complete" -Completed $BackupComplete = $true if ($server.VersionMajor -eq '8') { $HeaderInfo = Get-BackupAncientHistory -SqlInstance $server -Database $dbname } else { $HeaderInfo = Get-DbaDbBackupHistory -SqlInstance $server -Database $dbname @gbhSwitch -IncludeCopyOnly -RecoveryFork $db.RecoveryForkGuid | Sort-Object -Property End -Descending | Select-Object -First 1 } $Verified = $false if ($Verify) { $verifiedresult = [PSCustomObject]@{ ComputerName = $server.ComputerName InstanceName = $server.ServiceName SqlInstance = $server.DomainInstanceName DatabaseName = $dbname BackupComplete = $BackupComplete BackupFilesCount = $FinalBackupPath.Count BackupFile = (Split-Path $FinalBackupPath -Leaf) BackupFolder = (Split-Path $FinalBackupPath | Sort-Object -Unique) BackupPath = ($FinalBackupPath | Sort-Object -Unique) Script = $script Notes = $failures -join (',') FullName = ($FinalBackupPath | Sort-Object -Unique) FileList = $FileList SoftwareVersionMajor = $server.VersionMajor Type = $outputType FirstLsn = $HeaderInfo.FirstLsn DatabaseBackupLsn = $HeaderInfo.DatabaseBackupLsn CheckPointLsn = $HeaderInfo.CheckPointLsn LastLsn = $HeaderInfo.LastLsn BackupSetId = $HeaderInfo.BackupSetId LastRecoveryForkGUID = $HeaderInfo.LastRecoveryForkGUID EncryptorName = $encryptionOptions.EncryptorName KeyAlgorithm = $encryptionOptions.Algorithm EncruptorType = $encryptionOptions.encryptorType } | Restore-DbaDatabase -SqlInstance $server -DatabaseName DbaVerifyOnly -VerifyOnly -TrustDbBackupHistory -DestinationFilePrefix DbaVerifyOnly if ($verifiedResult[0] -eq "Verify successful") { $failures += $verifiedResult[0] $Verified = $true } else { $failures += $verifiedResult[0] $Verified = $false } } $HeaderInfo | Add-Member -Type NoteProperty -Name BackupComplete -Value $BackupComplete $HeaderInfo | Add-Member -Type NoteProperty -Name BackupFile -Value (Split-Path $FinalBackupPath -Leaf) $HeaderInfo | Add-Member -Type NoteProperty -Name BackupFilesCount -Value $FinalBackupPath.Count if ($FinalBackupPath[0] -eq 'NUL:') { $pathresult = "NUL:" } else { $pathresult = (Split-Path $FinalBackupPath | Sort-Object -Unique) } $HeaderInfo | Add-Member -Type NoteProperty -Name BackupFolder -Value $pathresult $HeaderInfo | Add-Member -Type NoteProperty -Name BackupPath -Value ($FinalBackupPath | Sort-Object -Unique) $HeaderInfo | Add-Member -Type NoteProperty -Name DatabaseName -Value $dbname $HeaderInfo | Add-Member -Type NoteProperty -Name Notes -Value ($failures -join (',')) $HeaderInfo | Add-Member -Type NoteProperty -Name Script -Value $script $HeaderInfo | Add-Member -Type NoteProperty -Name Verified -Value $Verified } else { $backup.Script($server) } } } catch { if ($NoRecovery -and ($_.Exception.InnerException.InnerException.InnerException -like '*cannot be opened. It is in the middle of a restore.')) { Write-Message -Message "Exception thrown by db going into restoring mode due to recovery" -Leve Verbose } else { Write-Progress -id $ProgressId -activity "Backup" -status "Failed" -completed Stop-Function -message "Backup Failed" -ErrorRecord $_ -Continue $BackupComplete = $false } } } $OutputExclude = 'FullName', 'FileList', 'SoftwareVersionMajor' if ($failures.Count -eq 0) { $OutputExclude += ('Notes', 'FirstLsn', 'DatabaseBackupLsn', 'CheckpointLsn', 'LastLsn', 'BackupSetId', 'LastRecoveryForkGuid') } $headerinfo | Select-DefaultView -ExcludeProperty $OutputExclude $FilePath = $null } } } |