Cmdlet Restore-ASDatabase

Restaura um banco de dados multidimensional ou tabular de um arquivo de backup (.abf) do Analysis Services.

Sintaxe

Restore-ASDatabase [-RestoreFile] <string> [-Name] <string> [-AllowOverwrite <SwitchParameter>] Locations <Microsoft.AnalysisServices.RestoreLocation[]>] [-Security <Microsoft.AnalysisServices.RestoreSecurity>] [-Password <System.SecureString>] [-StorageLocation <System.string>] [-Server <string>] [-Credential <PSCredential>] [<CommonParameters>]

Descrição

Permite que um administrador de sistemas do Analysis Services restaure um banco de dados multidimensional ou tabular de um arquivo de backup (.abf) do Analysis Services. Se o arquivo que você estiver restaurando estiver criptografado, use –FilePassword para fornecer a senha que é usada para descriptografar o arquivo.

Esse cmdlet oferece suporte ao parâmetro –Credential, que pode ser usado se você configurar a instância do Analysis Services para acesso HTTP. O parâmetro –Credential usa o objeto PSCredential que fornece uma identidade de usuário do Windows. O IIS representará esse usuário ao conectar-se ao Analysis Services. A identidade deve ter permissões de administrador de sistema na instância do Analysis Services para restaurar o arquivo.

Parâmetros

-RestoreFile <cadeia de caracteres>

Especifica o caminho e o nome do arquivo a ser restaurado. Se você especificar apenas o nome do arquivo, sem o caminho, que o local de backup padrão será usado.

-Name <cadeia de caracteres>

Especifica o banco de dados do Analysis Services a ser restaurado.

-AllowOverwrite <SwitchParameter>

Substitui um banco de dados que usa o mesmo nome e local.

-Locations <Microsoft.AnalysisServices.RestoreLocation[]>

Especifica o local remoto das partições remotas a serem restauradas.

-Security <Microsoft.AnalysisServices.RestoreSecurity>

Representa as configurações de segurança usadas na operação de restauração. Os valores válidos são CopyAll, SkipMembership, IgnoreSecurity. CopyAll restaura funções e membros. SkipMembership apenas recria a função. IgnoreSecurity restaura o banco de dados, sem funções.

-Password <SecureString>

Especifica uma senha a ser usada para restaurar um arquivo de backup criptografado. Você deve especificar a senha que foi usada originalmente para criptografar o arquivo.

-StorageLocation <string>

Especifica o local de armazenamento do banco de dados. Este é o local dos arquivos de banco de dados no sistema de arquivos. Defina este parâmetro se você não estiver usando o local padrão, que é a pasta de backup da instância de destino.

-Server <cadeia de caracteres>

Especifica a instância do Analysis Services que o cmdlet conectará e executará. Se nenhum nome de servidor for fornecido, uma conexão será feita com o localhost. Para instâncias padrão, especifique apenas o nome do servidor. Para instâncias nomeadas, use o formato nome_do_servidor\nome_da_instância. Para conexões HTTP, use o formato http[s]://servidor[:porta]/diretório_virtual/msmdpump.dll.

-Credential <PSCredential>

Especifica um objeto –Credential que fornece um nome de usuário e senha do Windows. Especifique esse parâmetro somente se a instância do Analysis Services estiver configurada para acesso HTTP, usando a autenticação básica. Para conexões nativas que usam a segurança integrada, esse parâmetro é ignorado.

Se esse parâmetro estiver presente, as credenciais que ele fornece serão anexadas à cadeia de conexão. O IIS representará essa identidade de usuário ao conectar-se ao Analysis Services. Se nenhuma credencial for especificada, será usada a conta do Windows padrão do usuário que está executando a ferramenta.

Para usar este parâmetro, primeiro crie um objeto PSCredential usando Get-Credential para especificar o nome de usuário e a senha (por exemplo, $Cred=Get-Credential “adventure-works\admin”. Você pode transportar este objeto para o parâmetro –Credential (-Credential:$Cred).

Para obter mais informações sobre a autenticação e o uso de credenciais, consulte Analysis Services PowerShell. Para obter mais informações sobre o acesso à HTTP, consulte Configurar o acesso HTTP ao Analysis Services no IIS (Serviços de Informações da Internet 7.0.

<CommonParameters>

Este cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte About_CommonParameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode transportar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Exemplo 1

PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase awtest.abf testawrestoredb –security:CopyAll

Este comando restaura um arquivo de backup (awtest.abf) do Analysis Services na pasta de backup local para a instância padrão do Analysis Services local. O nome do banco de dados não precisa existir; nesse caso, o nome do banco de dados é especificado como parte da operação de restauração. Adicionar –Security:CopyAll preenche as funções e a associação de função do banco de dados de backup no novo banco de dados restaurado.

Exemplo 2

PS SQLSERVER:\SQLAS\Localhost\default > $pwd = read-host –AsSecureString –Prompt “Password” 
PS SQLSERVER:\SQLAS\Localhost\default > $pwd -is [System.IDisposable] 
PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase –restorefile testdb.abf –name AWTEST2 –password:$pwd
PS SQLSERVER:\SQLAS\Localhost\default >$pwd.Dispose()
PS SQLSERVER:\SQLAS\Localhost\default >Remove-Variable –Name pwd

As linhas 1 e 2 são usadas para solicitar a senha usada para criptografar o arquivo.

A linha 3 restaura um arquivo de backup (testdb.abf) criptografado do Analysis Services de uma pasta de backup local de uma instância padrão do Analysis Services.

As linhas 4 e 5 removem a senha.

Exemplo 3

PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase –restorefile “\\myremoteserver\backups\testdb.abf” –name Contoso_Retail –server myremoteserver –storagelocation “\\myremoteserver\restoreDBFiles”

Este comando restaura um arquivo de backup (testdb.abf) criptografado do Analysis Services em uma pasta de backup remota de uma instância padrão remota do Analysis Services. O parâmetro –StorageLocation é usado para colocar os arquivos de banco de dados em um local não padrão. Neste caso, um arquivo compartilhado denominado restoreDBfiles.

Consulte também

Conceitos

Analysis Services PowerShell

Outros recursos

Gerenciar modelos tabulares usando o PowerShell