Backup-SqlDatabase

Referência

Módulo:: SQLPS

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

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

Default
Ativado
Desativado

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

-Confirm

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

-DatabaseObject

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

Type:	Database
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
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

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

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

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