Командлет Restore-ASDatabase
Восстанавливает многомерную или табличную базу данных из файла резервной копии служб 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, чтобы указать пароль, который будет использоваться для расшифровки файла.
Этот командлет поддерживает параметр –Credential, который можно использовать, если экземпляр служб Analysis Services настроен для доступа по протоколу HTTP. Параметр –Credential принимает объект PSCredential, который содержит идентификатор пользователя Windows. Службы IIS будут олицетворять этого пользователя при подключении к службам Analysis Services. Чтобы восстановить файл, необходимо обладать разрешениями системного администратора на этом экземпляре служб Analysis Services.
Параметры
-RestoreFile <строка>
Задает путь и имя восстанавливаемого файла. Если указать только имя файла без пути, будет использоваться хранилище резервных копий по умолчанию.
Обязательное поле? |
true |
Положение? |
0 |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Name <строка>
Указывает базу данных служб 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 <строка>
Указывает место хранения базы данных. Это расположение файлов базы данных в файловой системе. Установите этот параметр, если используется не расположение по умолчанию, которое соответствует папке резервных копий на целевом экземпляре.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Server <строка>
Указывает экземпляр служб Analysis Services, к которому подключится командлет и где он будет выполняться. Если имя сервера не указано, произойдет подключение к серверу localhost. Для экземпляров по умолчанию достаточно указать имя сервера. Для именованных экземпляров используйте формат имя_сервера\имя_экземпляра. Для HTTP-соединений используйте формат http[s]://server[:port]/virtualdirectory/msmdpump.dll.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
localhost |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Credential <PSCredential>
Указывает объект PSCredential, который содержит имя пользователя и пароль Windows. Укажите этот параметр, только если экземпляр служб Analysis Services настроен для доступа HTTP с использованием обычной проверки подлинности. Для соединений в собственном режиме, в которых используются интегрированные функции безопасности, этот параметр не учитываются.
Если этот параметр указан, учетные данные, которые он содержит, добавляются в строку подключения. Службы IIS будут олицетворять этого пользователя при соединении со службами Analysis Services. Если учетные данные не будут указаны, будут использованы учетные данные по умолчанию для пользователя, который запускает это средство.
Для использования этого параметра необходимо сначала создать объект PSCredential с помощью командлета Get-Credential, чтобы указать имя пользователя и пароль (например, $Cred=Get-Credential “adventure-works\admin”; этот объект можно затем передать по конвейеру в параметр –Credential (-Credential:$Cred).
Дополнительные сведения о проверке подлинности и использовании учетных данных см. в разделе Analysis Services PowerShell. Дополнительные сведения о доступе по протоколу HTTP см. в разделе Настройка HTTP-доступа к службам Analysis Services в службах Internet Information Services (IIS) 7.0.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
True (ByValue) |
Принимать символы-шаблоны? |
false |
<Общие параметры>
Этот командлет поддерживает общие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе About_CommonParameters.
Входы и выходы
Входной тип — это тип объектов, которые можно направить в командлет. Возвращаемый тип — это тип объектов, возвращаемых командлетом.
Входы |
System.String В командлет можно передавать по конвейеру строковые значения. |
Выходы |
Отсутствуют. |
Пример 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 используется для восстановления зашифрованного файла резервной копии (testdb.abf) из локальной папки резервных копий экземпляра служб Analysis Services по умолчанию.
Строки 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.