Restore-ASDatabase cmdlet

项目
05/08/2013

从 Analysis Services 备份 (.abf) 文件还原多维或表格数据库。

语法

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

说明

使 Analysis Services 系统管理员能够从某一备份 (.abf) 文件还原多维或表格数据库。如果您正在还原的文件已加密，则可以使用 –FilePassword 提供用于对该文件进行解密的密码。

此 cmdlet 支持 –Credential 参数，该参数可在您配置 Analysis Services 实例以进行 HTTP 访问时使用。 –Credential 参数具有可提供 Windows 用户标识的 PSCredential 对象。之后，IIS 将在连接到 Analysis Services 时模拟该用户。此标识必须对 Analysis Services 实例具有系统管理员权限才能还原文件。

参数

-RestoreFile <string>

指定要还原的文件的路径和名称。如果仅指定了文件名，而没有指定路径，将假定为默认备份位置。

必需？	true
位置？	0
默认值
接受管道输入？	false
接受通配符？	false

-Name <string>

指定要还原的 Analysis Services 数据库。

必需？	true
位置？	1
默认值
接受管道输入？	false
接受通配符？	false

-AllowOverwrite <SwitchParameter>

覆盖使用相同名称和位置的数据库。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-Locations <Microsoft.AnalysisServices.RestoreLocation[]>

指定要还原的分区的远程位置。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-Security <Microsoft.AnalysisServices.RestoreSecurity>

表示用于还原操作的安全设置。有效值为 CopyAll、SkipMembership、IgnoreSecurity。 CopyAll 将还原角色和成员身份。 SkipMembership 仅重新创建角色。 IgnoreSecurity 还原数据库，而不还原角色。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-Password <SecureString>

指定用于还原已加密的备份文件的密码。您必须指定最初用于加密文件的密码。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-StorageLocation <string>

指定数据库存储位置。这是文件系统上数据库文件所在的位置。如果您未在使用默认位置（该默认位置是目标实例的备份文件夹），则设置此参数。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-Server <string>

指定 cmdlet 要连接和执行的 Analysis Services 实例。如果未提供服务器名称，将连接到本地主机。对于默认实例，仅指定服务器名称。对于命名实例，请使用格式 servername\instancename。对于 HTTP 连接，请使用格式 http[s]://server[:port]/virtualdirectory/msmdpump.dll。

必需？	false
位置？	所指定位置
默认值	localhost
接受管道输入？	false
接受通配符？	false

-Credential <PSCredential>

指定可提供 Windows 用户名和密码的 PSCredential 对象。仅当配置 Analysis Services 实例以使用基本身份验证进行 HTTP 访问时指定此参数。对于使用集成安全性的本机连接，将忽略此参数。

如果此参数存在，则将其提供的凭据追加到连接字符串。 IIS 将在连接到 Analysis Services 时模拟该用户标识。如果未指定凭据，将使用正在运行该工具的用户的默认 Windows 帐户。

若要使用此参数，请首先使用 Get-Credential 创建一个 PSCredential 对象，以便指定用户名和密码（例如 $Cred=Get-Credential “adventure-works\admin”）。然后，可以将此对象传送到 –Credential 参数 (-Credential:$Cred)。

有关身份验证和凭据使用的详细信息，请参阅 Analysis Services PowerShell。有关 HTTP 访问的详细信息，请参阅配置对 Internet Information Services (IIS) 7.0 上 Analysis Services 的 HTTP 访问。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	True (ByValue)
接受通配符？	false

<CommonParameters>

此 cmdlet 支持以下常用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 About_CommonParameters。

输入和输出

输入类型是可以传送到 cmdlet 的对象的类型。返回类型是 cmdlet 所返回的对象的类型。

输入

System.string

可以将字符串值传输到 cmdlet。

输出

无。

示例 1

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

此命令将本地备份文件夹中的 Analysis Services 备份文件 (awtest.abf) 还原到本地 Analysis Services 默认实例。数据库名称不必存在；在这个例子中，该数据库名称指定为还原操作的一部分。添加 –Security:CopyAll 可以将角色和角色成员身份从备份数据库填充到新的还原的数据库。

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

第 1 和第 2 行用于提示输入已用于加密文件的密码。

第 3 行从 Analysis Services 默认实例的本地备份文件夹还原已加密的 Analysis Services 备份文件 (testdb.abf)。

第 4 行和第 5 行用于删除密码。

示例 3

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

此命令将已加密的 Analysis Services 备份文件 (testdb.abf) 还原到远程 Analysis Services 默认实例上的远程备份文件夹中。 –StorageLocation 参数用于将数据库文件放置于非默认位置，在这个例子中，将放置于名为 restoreDBfiles 的共享文件中。

通过