Backup-SqlDatabase

Referência

Módulo:: SQLServer

Faz backup de objetos de banco de dados do SQL Server.

Sintaxe

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

Description

O cmdlet Backup-SqlDatabase executa operações de backup em um banco de dados do SQL Server.

Isso inclui backups completos de banco de dados, backups de log de transações e backups de arquivos de banco de dados.

Esse cmdlet é modelado após a classe Microsoft.SqlServer.Management.Smo.Backup.

Os parâmetros nessa classe geralmente correspondem às propriedades desse objeto Smo.

Para fazer backup de um banco de dados pelo caminho da instância do servidor e pelo nome do banco de dados, especifique o caminho da instância do servidor no parâmetro Path e o nome do banco de dados no parâmetro Banco de Dados.

Para fazer backup de um banco de dados usando um objeto Smo.Server e um nome de banco de dados, especifique o objeto Smo.Server no parâmetro InputObject, diretamente ou usando o operador de pipeline e o nome do banco de dados no parâmetro Banco de Dados.

Para fazer backup de um banco de dados por instância de servidor e nome de banco de dados, especifique a instância do servidor no parâmetro ServerInstance e o nome do banco de dados no parâmetro Banco de Dados.

Para fazer backup de um banco de dados usando um objeto Smo.Database, especifique o objeto Smo.Database no parâmetro DatabaseObject, diretamente ou usando o operador de pipeline.

Por padrão, esse cmdlet executa um backup de banco de dados completo.

Defina o tipo do backup usando o parâmetro BackupAction.

Por padrão, o arquivo de backup é armazenado no local de backup do servidor padrão sob o nome databasename.bak para backups completos e/ou de arquivos e sob o nome databasename.trn para backups de log. Para especificar um nome de arquivo diferente, use o parâmetro BackupFile.

Para especificar um local de arquivo de backup e usar um nome de arquivo gerado automaticamente, especifique o local usando o parâmetro BackupContainer.

Exemplos

Exemplo 1: Fazer backup de um banco de dados completo

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

Esse comando cria um backup de banco de dados completo do banco de dados chamado 'MainDB' para o local de backup padrão da instância do servidor 'Computer\Instance'. O arquivo de backup é denominado 'MainDB.bak'.

Exemplo 2: Fazer backup de um banco de dados com base no local

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

Esse comando cria um backup de banco de dados completo do banco de dados 'MainDB' para o local de backup padrão da instância do servidor 'Computer\Instance'. O diretório de trabalho atual é usado para determinar a instância do servidor em que o backup ocorre.

Exemplo 3: Fazer backup do log de transações

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

Esse comando cria um backup do log de transações do banco de dados 'MainDB' para o local de backup padrão da instância do servidor 'Computer\Instance'. O arquivo de backup é denominado 'MainDB.trn'.

Exemplo 4: Fazer backup de um banco de dados e solicitar credenciais

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

Esse comando cria um backup de banco de dados completo do banco de dados 'MainDB' usando o logon 'sa' do SQL Server. Esse comando solicita uma senha para concluir a autenticação.

Exemplo 5: Fazer backup de um banco de dados em um compartilhamento de arquivos de rede

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

Esse comando cria um backup de banco de dados completo do banco de dados 'MainDB' para o arquivo "\\mainserver\databasebackup\MainDB.bak".

Exemplo 6: Fazer backup de todos os bancos de dados em uma instância de servidor

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

Esse comando faz backup de todos os bancos de dados na instância de servidor 'Computer\Instance' para o local de backup padrão. Os arquivos de backup são nomeados <nome do banco de dados>.bak.

Exemplo 7: Fazer backup de todos os bancos de dados em uma instância de servidor para um compartilhamento de arquivos de rede

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

Esse comando cria um backup completo para cada banco de dados na instância de servidor 'Computer\Instance' para o compartilhamento "\\mainserver\databasebackup". Os arquivos de backup são nomeados <nome do banco de dados>.bak.

Exemplo 8: Fazer backup de todos os arquivos em grupos de arquivos secundários

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

Esse comando cria um backup de arquivo completo de cada arquivo nos grupos de arquivos secundários 'FileGroupJan' e 'FileGroupFeb'.

Exemplo 9: Criar um backup diferencial

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

Esse comando cria um backup diferencial do banco de dados 'MainDB' para o local de backup padrão da instância do servidor 'Computer\Instance'. O arquivo de backup é denominado "MainDB.bak".

Exemplo 10: Criar um backup para uma unidade de fita

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

Esse comando cria um backup completo do MainDB do banco de dados para o dispositivo de fita "\\.\tape0". Para representar esse dispositivo, o comando constrói uma instância do objeto Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. O construtor usa dois argumentos, o nome do dispositivo de backup e o tipo do dispositivo de backup. Esse objeto BackupDeviceItem é passado para o parâmetro BackupDevice do cmdlet Backup-SqlDatabase .

Exemplo 11: Fazer backup de um banco de dados no serviço de Armazenamento de Blobs do Azure

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

Esse comando cria um backup completo do banco de dados 'MainDB' para o serviço de Armazenamento de Blobs do Windows Azure. Ele usa BackupContainer para especificar o local (URL) do contêiner de Blob do Windows Azure. O nome do arquivo de backup é gerado automaticamente. O parâmetro SqlCredential é usado para especificar o nome da credencial do SQL Server que armazena as informações de autenticação.

Exemplo 12: Fazer backup de um banco de dados no serviço de Armazenamento de Blobs do Azure e especificar o nome do arquivo

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

Esse comando cria um backup completo do MainDB do banco de dados para o serviço de Armazenamento de Blobs do Windows Azure. Ele usa o parâmetro BackupFile para especificar o local (URL) e o nome do arquivo de backup. O parâmetro SqlCredential é usado para especificar o nome da credencial do SQL Server.

Exemplo 13: Fazer backup de todos os bancos de dados para o serviço de Armazenamento de Blobs do Azure

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

Esse comando faz backup de todos os bancos de dados na instância de servidor 'Computer\Instance' para o local do serviço armazenamento de blobs do Windows Azure usando o parâmetro BackupContainer. Os nomes de arquivo de backup são gerados automaticamente.

Exemplo 14: Criar um backup criptografado

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

Este exemplo cria as opções de criptografia e a usa como um valor de parâmetro em Backup-SqlDatabase para criar um backup criptografado.

Parâmetros

-AccessToken

O token de acesso usado para autenticar no SQL Server, como uma alternativa ao usuário/senha ou à Autenticação do Windows.

Isso pode ser usado, por exemplo, para se conectar a SQL Azure DB e SQL Azure Managed Instance usando um Service Principal ou um Managed Identity.

O parâmetro a ser usado pode ser uma cadeia de caracteres que representa o token ou um objeto PSAccessToken conforme retornado executando Get-AzAccessToken -ResourceUrl https://database.windows.net.

Esse parâmetro é novo na v22 do módulo.

Tipo:	PSObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupAction

Especifica o tipo de operação de backup a ser executada. Os valores válidos são:

Base de dados. Faz backup de todos os arquivos de dados no banco de dados.
Limas. Faz backup de arquivos de dados especificados nos parâmetros DatabaseFile ou DatabaseFileGroup.
Tora. Faz backup do log de transações.

Tipo:	BackupActionType
Valores aceitos:	Database, Files, Log
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupContainer

Especifica a pasta ou o local em que o cmdlet armazena backups. Isso pode ser uma pasta em um disco ou URL para um contêiner de Blobs do Azure. Esse parâmetro pode ser útil ao fazer backup de vários bancos de dados em uma determinada instância. Esse parâmetro não pode ser usado com um parâmetro BackupDevice. O parâmetro BackupContainer não pode ser usado com o parâmetro BackupFile.

O caminho usado para especificar o local deve terminar com uma barra (/).

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupDevice

Especifica os dispositivos em que os backups são armazenados. Esse parâmetro não pode ser usado com o parâmetro BackupFile. Use esse parâmetro se você estiver fazendo backup em fita.

Tipo:	BackupDeviceItem[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupFile

Especifica o local e o nome do arquivo para o backup.

Esse é um parâmetro opcional.

Se não for especificado, os backups serão armazenados no local de backup padrão do servidor sob o nome databasename.bak para backups completos e de arquivos ou databasename.trn para backups de log.

Ao fazer backup em vários arquivos, separe os nomes de arquivo com vírgulas, por exemplo: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Esse parâmetro não pode ser usado com os parâmetros -BackupDevice ou -BackupContainer.

Tipo:	String[]
Cargo:	2
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupSetDescription

Especifica a descrição do conjunto de backup. Esse parâmetro é opcional.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackupSetName

Especifica o nome do conjunto de backup.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BlockSize

Especifica o tamanho do bloco físico para o backup, em bytes. Os tamanhos com suporte são 512, 1024, 2048, 4096, 8192, 16384, 32768 e 65536 (64 KB). O padrão é 65536 para dispositivos de fita e 512 para todos os outros dispositivos.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BufferCount

Especifica o número de buffers de E/S a serem usados para a operação de backup. Você pode especificar qualquer inteiro positivo. Se houver espaço de endereço virtual insuficiente no processo de Sqlservr.exe para os buffers, você receberá um erro de memória insuficiente.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Checksum

Indica que um valor de soma de verificação é calculado durante a operação de backup.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CompressionOption

Especifica as opções de compactação para a operação de backup.

Tipo:	BackupCompressionOptions
Valores aceitos:	Default, On, Off
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet. Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ConnectionTimeout

Especifica o número de segundos para aguardar uma conexão de servidor antes de uma falha no tempo limite. O valor de tempo limite deve ser um inteiro entre 0 e 65534. Se 0 for especificado, as tentativas de conexão não têm tempo limite.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ContinueAfterError

Indica que a operação continua quando ocorre um erro de soma de verificação. Se não estiver definida, a operação falhará após um erro de soma de verificação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CopyOnly

Indica que o backup é um backup somente cópia. Um backup somente cópia não afeta a sequência normal de seus backups convencionais agendados regularmente.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Credential

Especifica um objeto PSCredential que contém as credenciais de um logon do SQL Server que tem permissão para executar essa operação. Esse não é o objeto de credencial SQL usado para armazenar informações de autenticação internamente pelo SQL Server ao acessar recursos fora do SQL Server.

Tipo:	PSCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Database

Especifica o nome do banco de dados a ser backup. Esse parâmetro não pode ser usado com o parâmetro DatabaseObject. Quando esse parâmetro é especificado, os parâmetros Path, InputObject ou ServerInstance também devem ser especificados.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DatabaseFile

Especifica um ou mais arquivos de banco de dados para fazer backup. Esse parâmetro só é usado quando BackupAction é definido como Arquivos. Quando BackupAction é definido como Arquivos, o parâmetro DatabaseFileGroups ou DatabaseFiles deve ser especificado.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DatabaseFileGroup

Especifica os grupos de arquivos de banco de dados direcionados pela operação de backup. Esse parâmetro só é usado quando a propriedade BackupAction é definida como Arquivos. Quando o parâmetro BackupAction é definido como Arquivos, o parâmetro DatabaseFileGroups ou DatabaseFiles deve ser especificado.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DatabaseObject

Especifica o objeto de banco de dados para a operação de backup.

Tipo:	Database
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Encrypt

O tipo de criptografia a ser usado ao se conectar ao SQL Server.

Esse valor é mapeado para a propriedade EncryptSqlConnectionEncryptOption no objeto SqlConnection do driver Microsoft.Data.SqlClient.

Na v22 do módulo, o padrão é Optional (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será 'Obrigatório', o que pode criar uma alteração significativa para scripts existentes.

Esse parâmetro é novo na v22 do módulo.

Tipo:	String
Valores aceitos:	Mandatory, Optional, Strict
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EncryptionOption

Especifica as opções de criptografia para a operação de backup.

Tipo:	BackupEncryptionOptions
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ExpirationDate

Especifica a data e a hora em que o conjunto de backup expira e os dados de backup não são mais considerados válidos. Isso só pode ser usado para dados de backup armazenados em dispositivos de disco ou fita. Os conjuntos de backup mais antigos que a data de validade estão disponíveis para serem substituídos por um backup posterior.

Tipo:	DateTime
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-FormatMedia

Indica que a fita está formatada como a primeira etapa da operação de backup. Isso não se aplica a um backup de disco.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HostNameInCertificate

O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Você deve passar esse parâmetro se a instância do SQL Server estiver habilitada para o Force Encryption e quiser se conectar a uma instância usando nome de host/nome curto. Se esse parâmetro for omitido, passar o FQDN (Nome de Domínio Totalmente Qualificado) para -ServerInstance será necessário para se conectar a uma instância do SQL Server habilitada para o Force Encryption.

Esse parâmetro é novo na v22 do módulo.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Incremental

Indica que um backup diferencial é executado.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Initialize

Indica que os dispositivos associados à operação de backup são inicializados. Isso substitui todos os conjuntos de backup existentes na mídia e torna esse backup o primeiro conjunto de backup na mídia.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifica o objeto do servidor para o local de backup.

Tipo:	Server[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-LogTruncationType

Especifica o comportamento de truncamento para backups de log. Os valores válidos são:

-- TruncateOnly -- NoTruncate -- Truncado

O valor padrão é Truncado.

Tipo:	BackupTruncateLogType
Valores aceitos:	TruncateOnly, NoTruncate, Truncate
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MaxTransferSize

Especifica o número máximo de bytes a serem transferidos entre a mídia de backup e a instância do SQL Server. Os valores possíveis são múltiplos de 65536 bytes (64 KB), até 4194304 bytes (4 MB).

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MediaDescription

Especifica a descrição do meio que contém o conjunto de backup. Esse parâmetro é opcional.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MediaName

Especifica o nome usado para identificar o conjunto de mídias.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MirrorDevices

Especifica uma matriz de objetos BackupDeviceList usados pelo backup espelhado.

Tipo:	BackupDeviceList[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NoRecovery

Indica que a extremidade final do log não tem backup. Quando restaurado, o banco de dados está no estado de restauração. Quando não definido, o final final do log é feito com backup. Isso só se aplica quando o parâmetro BackupAction é definido como Log.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NoRewind

Indica que uma unidade de fita é deixada aberta na posição final quando o backup é concluído. Quando não definido, a fita é relançada após a conclusão da operação. Isso não se aplica a backups de disco ou URL.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Indica que o cmdlet gera o objeto Smo.Backup que executou o backup.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

Especifica o caminho para a instância do SQL Server para executar a operação de backup. Esse é um parâmetro opcional. Se não for especificado, o valor desse parâmetro será padrão para o local de trabalho atual.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

Tipo:	ActionPreference
Aliases:	proga
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Restart

Indica que o cmdlet continua processando uma operação de backup parcialmente concluída. Se não estiver definido, o cmdlet reiniciará uma operação de backup interrompida no início do conjunto de backup.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RetainDays

Especifica o número de dias que devem ser decorridos antes que um conjunto de backup possa ser substituído. Isso só pode ser usado para dados de backup armazenados em dispositivos de disco ou fita.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Script

Indica que esse cmdlet gera um script Transact-SQL que executa a operação de backup.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServerInstance

Especifica o nome de uma instância do SQL Server. Essa instância de servidor torna-se o destino da operação de backup.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SkipTapeHeader

Indica que o cabeçalho da fita não é lido.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SqlCredential

Especifica um objeto de credencial do SQL Server que armazena informações de autenticação. Se estiver fazendo backup no serviço de Armazenamento de Blobs, especifique esse parâmetro. As informações de autenticação armazenadas incluem o nome da conta de armazenamento e os valores de chave de acesso associados. Não especifique esse parâmetro para disco ou fita.

Tipo:	PSObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StatementTimeout

Defina o tempo limite (em segundos) para a operação de backup.

Se o valor for 0 ou o parâmetro StatementTimeout não for especificado, a operação de restauração não terá tempo limite.

Tipo:	Int32
Cargo:	Named
Valor padrão:	0
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrustServerCertificate

Indica se o canal será criptografado ao ignorar a cadeia de certificados para validar a confiança.

Na v22 do módulo, o padrão é $true (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será "$false", o que pode criar uma alteração significativa para scripts existentes.

Esse parâmetro é novo na v22 do módulo.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UndoFileName

Especifica o nome do arquivo de desfazer usado para armazenar transações não confirmadas que são revertidas durante a recuperação.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UnloadTapeAfter

Indica que o dispositivo de fita é relançado e descarregado quando a operação é concluída. Se não estiver definido, nenhuma tentativa será feita para retroceder e descarregar o meio de fita. Isso não se aplica a backups de disco ou URL.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado. Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Especifica um SMO. Objeto de servidor que se refere à instância do SQL Server na qual a operação de backup ocorre.

System.String[]

Saídas

System.Object

Restore-SqlDatabase

Compartilhar via

Backup-SqlDatabase

Sintaxe

Description

Exemplos

Exemplo 1: Fazer backup de um banco de dados completo

Exemplo 2: Fazer backup de um banco de dados com base no local

Exemplo 3: Fazer backup do log de transações

Exemplo 4: Fazer backup de um banco de dados e solicitar credenciais

Exemplo 5: Fazer backup de um banco de dados em um compartilhamento de arquivos de rede

Exemplo 6: Fazer backup de todos os bancos de dados em uma instância de servidor

Exemplo 7: Fazer backup de todos os bancos de dados em uma instância de servidor para um compartilhamento de arquivos de rede

Exemplo 8: Fazer backup de todos os arquivos em grupos de arquivos secundários

Exemplo 9: Criar um backup diferencial

Exemplo 10: Criar um backup para uma unidade de fita

Exemplo 11: Fazer backup de um banco de dados no serviço de Armazenamento de Blobs do Azure

Exemplo 12: Fazer backup de um banco de dados no serviço de Armazenamento de Blobs do Azure e especificar o nome do arquivo

Exemplo 13: Fazer backup de todos os bancos de dados para o serviço de Armazenamento de Blobs do Azure

Exemplo 14: Criar um backup criptografado

Parâmetros

-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

Entradas

Saídas

Links Relacionados

Comentários

Recursos adicionais