Cmdlet Restore-ASDatabase
Restaura una base de datos tabular o multidimensional a partir de un archivo de copia de seguridad de Analysis Services (.abf).
Sintaxis
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>]
Descripción
Permite a un administrador del sistema de Analysis Services restaurar una base de datos multidimensional o tabular a partir de un archivo de copia de seguridad (.abf). Si el archivo que se está restaurando se cifró, puede usar –FilePassword para proporcionar la contraseña que se utiliza para descifrar el archivo.
Este cmdlet admite el parámetro –Credential, que se puede usar si configuró la instancia de Analysis Services para el acceso HTTP. El parámetro –Credential toma un objeto PSCredential que proporciona una identidad de usuario de Windows. A continuación, IIS suplantará a este usuario al conectarse a Analysis Services. La identidad debe tener permisos de administrador del sistema en la instancia de Analysis Services para restaurar el archivo.
Parámetros
-RestoreFile <string>
Especifica la ruta de acceso y el nombre del archivo que desea restaurar. Si especifica solo el nombre de archivo, sin una ruta de acceso, se supone la ubicación predeterminada de las copias de seguridad.
¿Obligatorio? |
true |
¿Posición? |
0 |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Name <string>
Especifica la base de datos de Analysis Services que se va a restaurar.
¿Obligatorio? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-AllowOverwrite <SwitchParameter>
Sobrescribe una base de datos que usa el mismo nombre y ubicación.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Locations <Microsoft.AnalysisServices.RestoreLocation[]>
Especifica la ubicación remota de las particiones que se van a restaurar.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Security <Microsoft.AnalysisServices.RestoreSecurity>
Representa la configuración de seguridad utilizada para la operación de restauración. Los valores válidos son CopyAll, SkipMembership e IgnoreSecurity. CopyAll restaura los roles y los miembros. SkipMembership vuelve a crear solo el rol. IgnoreSecurity restaura la base de datos, sin roles.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Password <SecureString>
Especifica una contraseña que se utilizará para restaurar un archivo de copia de seguridad cifrado. Debe especificar la contraseña que se usó originalmente para cifrar el archivo.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-StorageLocation <string>
Especifica la ubicación de almacenamiento de base de datos. Es la ubicación de los archivos de la base de datos en el sistema de archivos. Establezca este parámetro si no utiliza la ubicación predeterminada, que es la carpeta de copia de seguridad de la instancia de destino.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Server <string>
Especifica la instancia de Analysis Services a la que el cmdlet se conectará y ejecutará. Si no se proporciona un nombre de servidor, se establecerá una conexión al host local. Para las instancias predeterminadas, especifique solo el nombre del servidor. Para las instancias con nombre, utilice el formato nombreDeServidor\nombreDeInstancia. En las conexiones HTTP, utilice el formato http[s]://server[:port]/virtualdirectory/msmdpump.dll.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
localhost |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Credential <PSCredential>
Especifica un objeto PSCredential que proporciona el nombre de usuario y contraseña de Windows. Especifique este parámetro solo si la instancia de Analysis Services está configurada para el acceso HTTP con autenticación básica. Para las conexiones nativas que usan seguridad integrada, este parámetro se omite.
Si este parámetro está presente, las credenciales que proporcione se anexan a la cadena de conexión. IIS suplantará esta identidad de usuario al conectarse a Analysis Services. Si no se especifica ninguna credencial, se usará la cuenta predeterminada de Windows del usuario que ejecuta la herramienta.
Para utilizar este parámetro, cree primero un objeto PSCredential con Get-Credential para especificar el nombre de usuario y la contraseña (por ejemplo, $Cred=Get-Credential “adventure-works\admin”. Después puede canalizar este objeto al parámetro –Credential (-Credential:$Cred).
Para obtener más información acerca de la autenticación y el uso de credenciales, vea Analysis Services PowerShell. Para obtener más información acerca del acceso HTTP, vea Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 7.0.
¿Obligatorio? |
false |
¿Posición? |
con nombre |
Valor predeterminado |
|
¿Aceptar la entrada de la canalización? |
True (ByValue) |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea Acerca de CommonParameters.
Entradas y salidas
El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet. El tipo de valor devuelto es el tipo de objeto que el cmdlet devuelve.
Entradas |
System.string Puede canalizar los valores de cadena al cmdlet. |
Salidas |
Ninguna. |
Ejemplo 1
PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase awtest.abf testawrestoredb –security:CopyAll
Este comando restaura un archivo de copia de seguridad de Analysis Services (awtest.abf) en la carpeta de copia de seguridad local a la instancia local predeterminada de Analysis Services. El nombre de la base de datos no tiene que existir; en este caso, el nombre de la base de datos se especifica como parte de la operación de restauración. Al agregar –Security:CopyAll se rellenan los roles y la pertenencia a roles desde la base de datos a la nueva base de datos restaurada.
Ejemplo 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
Las líneas 1 y 2 se usan para solicitar la contraseña que se usó para cifrar el archivo.
La línea 3 restaura un archivo de copia de seguridad cifrado de Analysis Services (testdb.abf) de una carpeta de copia de seguridad local de una instancia predeterminada de Analysis Services.
Las líneas 4 y 5 quitan la contraseña.
Ejemplo 3
PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase –restorefile “\\myremoteserver\backups\testdb.abf” –name Contoso_Retail –server myremoteserver –storagelocation “\\myremoteserver\restoreDBFiles”
Este comando restaura un archivo de copia de seguridad cifrado de Analysis Services (testdb.abf) en una carpeta de copia de seguridad remota en una instancia predeterminada de Analysis Services remota. El parámetro –StorageLocation se utiliza para colocar los archivos de base de datos en una ubicación que no es la predeterminada, en este caso, un archivo compartido denominado restoreDBfiles.