Backup-SqlDatabase

Referência

Módulo:: SQLPS

Faz backup SQL Server objetos de banco de dados.

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

Description

O cmdlet Backup-SqlDatabase executa operações de backup em um banco de dados 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 após a classe Microsoft.SqlServer.Management.Smo.Backup . Os parâmetros nessa classe geralmente correspondem às propriedades nesse 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 de servidor Computer\Instance. O arquivo de backup é nomeado 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 MainDB do banco de dados para o local de backup padrão da instância de 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 se chama 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 MainDB do banco de dados 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 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 do 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 Computador\Instância 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 MainDB do banco de dados para o local de backup padrão da instância do servidor Computer\Instance. O arquivo de backup é nomeado 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 MainDB do banco de dados para o serviço Armazenamento de Blobs do Azure do Windows. 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 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 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

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

Tipo:	BackupActionType
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 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 (/).

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 este parâmetro se 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 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 .

Tipo:	String[]
Cargo:	3
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) bytes. 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 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.

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. Os valores válidos são:

Default
Ativado
Desativado

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

-Confirm

Solicita sua 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 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.

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 isso não estiver configurado, haverá falha na operação depois de 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 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.

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:	2
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 o parâmetro 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 o parâmetro 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

-DatabaseObject

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

Tipo:	Database
Cargo:	2
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
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 é 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

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

O valor padrão é Truncate.

Tipo:	BackupTruncateLogType
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 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.

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

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á padronizado como 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

-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 de SQL Server. Esta 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 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.

Tipo:	PSObject
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 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.

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.

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

Especifica um SMO. Objeto server referente à instância de SQL Server na qual a operação de backup ocorre.

Restore-SqlDatabase

Compartilhar via