Backup-SqlDatabase

Referência

Módulo:: SQLServer

Faz backup SQL Server objetos de banco de dados.

Syntax

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

Description

O cmdlet Backup-SqlDatabase realiza 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 arquivo de banco de dados.

Esse cmdlet é modelado de acordo com 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 Database.

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

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

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 é chamado de '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 é chamado de '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' 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

Este comando faz backup de todos os bancos de dados na instância de servidor 'Computador\Instância' 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 é chamado de "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 para o serviço 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 do Windows Armazenamento de Blobs do Azure. Ele usa BackupContainer para especificar o local (URL) do contêiner de Blobs 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 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 Armazenamento de Blobs do Azure do Windows. 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 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 do servidor 'Computer\Instance' para o local de serviço do Windows Armazenamento de Blobs do 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 para SQL Server, como uma alternativa ao usuário/senha ou à Autenticação do Windows.

Isso pode ser usado, por exemplo, para se conectar SQL Azure DB e SQL Azure Managed Instance usar 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 PSAccessToken objeto conforme retornado executando Get-AzAccessToken -ResourceUrl https://database.windows.net.

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

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

-BackupAction

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

Banco de dados. Faz backup de todos os arquivos de dados do banco de dados.
Arquivos. Faz backup de arquivos de dados especificados nos parâmetros DatabaseFile ou DatabaseFileGroup.
Log. Faz backup do log de transações.

Type:	BackupActionType
Accepted values:	Database, Files, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Blob do Azure. Esse parâmetro pode ser útil ao fazer o backup de vários bancos de dados em 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 (/).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 este parâmetro se estiver fazendo backup em fita.

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

-BackupFile

Especifica o local e o nome do arquivo do 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. Esse parâmetro não pode ser usado com os parâmetros BackupDevice ou BackupContainer.

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

-BackupSetDescription

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

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

-BackupSetName

Especifica o nome do conjunto de backup.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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) bytes. O padrão é 65536 para dispositivos de fita e 512 para todos os outros dispositivos.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 não houver espaço de endereço virtual suficiente no processo de Sqlservr.exe para os buffers, você receberá um erro de memória insuficiente.

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

-Checksum

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

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

-CompressionOption

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

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

-Confirm

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

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

-ConnectionTimeout

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

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

-ContinueAfterError

Indica que a operação continua quando ocorre um erro de soma de verificação. Se isso não estiver configurado, haverá falha na operação depois de um erro de soma de verificação.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Credential

Especifica um objeto PSCredential que contém as credenciais de um logon 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 SQL Server ao acessar recursos fora do SQL Server.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DatabaseObject

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

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

-Encrypt

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

Esse valor é mapeado para a Encrypt propriedade SqlConnectionEncryptOption 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 interruptiva para scripts existentes.

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

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

-EncryptionOption

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

Type:	BackupEncryptionOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-FormatMedia

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 sua instância de 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 de SQL Server habilitada para o Force Encryption.

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

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

-Incremental

Indica que um backup diferencial é executado.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-InputObject

Especifica o objeto de servidor para o local de backup.

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

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Truncate

O valor padrão é Truncate.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-MediaDescription

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

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

-MediaName

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

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

-MirrorDevices

Especifica uma matriz de objetos BackupDeviceList usados pelo backup espelhado.

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

-NoRecovery

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

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

-NoRewind

Indica que uma unidade de fita é deixada aberta na posição final quando o backup é concluído. Quando isso não estiver configurado, a fita será rebobinada depois que a operação tiver sido concluída. Isso não se aplica a backups de disco ou URL.

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

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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á padronizado como o local de trabalho atual.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Script

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

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

-ServerInstance

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

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

-SkipTapeHeader

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

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

-SqlCredential

Especifica um objeto de credencial SQL Server que armazena informações de autenticação. Se você estiver fazendo backup no serviço de Armazenamento de Blobs, deverá especificar 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.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 atingirá o tempo limite.

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 interruptiva para scripts existentes.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-UnloadTapeAfter

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 de SQL Server na qual a operação de backup ocorre.

System.String[]

Saídas

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Syntax

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 para o serviço Armazenamento de Blobs do Azure

Exemplo 12: Fazer backup de um banco de dados no serviço 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 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

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Entradas

Saídas

Links Relacionados

Recursos adicionais