Restore-ASDatabase-Cmdlet

Stellt eine mehrdimensionale oder tabellarische Datenbank aus einer Analysis Services-Sicherungsdatei (.abf) wieder her.

Syntax

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

Beschreibung

Ermöglicht es einem Analysis Services-Systemadministrator, eine mehrdimensionale oder tabellarische Datenbank aus einer Sicherungsdatei wiederherzustellen. Wenn die Datei, die Sie wiederherstellen, verschlüsselt war, können Sie das Kennwort, das zum Verschlüsseln der Datei verwendet wurde, mit "-FilePassword" angeben.

Dieses Cmdlet unterstützt den –Credential-Parameter, der verwendet werden kann, wenn Sie die Analysis Services-Instanz für HTTP-Zugriff konfigurierten. Der –Credential-Parameter verwendet ein PSCredential-Objekt, das eine Windows-Benutzeridentität bereitstellt. Beim Herstellen einer Verbindung mit Analysis Services nimmt wird die Identität dieses Benutzers dann von IIS angenommen. Die Identität muss über Systemadministratorberechtigungen für die Analysis Services-Instanz verfügen, um eine Datei wiederherstellen zu können.

Parameter

-RestoreFile <string>

Gibt den Pfad und den Namen der wiederherzustellenden Datei an. Wenn Sie nur den Dateinamen ohne Pfad angeben, wird vom Standardsicherungsspeicherort ausgegangen.

-Name <string>

Gibt die Analysis Services-Datenbank an, die wiederhergestellt werden soll.

-AllowOverwrite <SwitchParameter>

Überschreibt eine Datenbank, die den gleichen Namen und Speicherort verwendet.

-Locations <Microsoft.AnalysisServices.RestoreLocation[]>

Gibt den Remotestandort der Partitionen an, die wiederhergestellt werden sollen.

-Security <Microsoft.AnalysisServices.RestoreSecurity>

Stellt die für den Wiederherstellungsvorgang verwendeten Sicherheitseinstellungen dar. Gültige Werte sind CopyAll, SkipMembership, IgnoreSecurity. CopyAll stellt Rollen und Mitgliedschaft wieder her. SkipMembership erstellt nur die Rolle neu. IgnoreSecurity stellt die Datenbank ohne Rollen wieder her.

-Password <SecureString>

Gibt ein Kennwort an, das verwendet werden soll, um eine verschlüsselte Sicherungsdatei wiederherzustellen. Sie müssen das Kennwort, das bei der ursprünglichen Verschlüsselung der Datei verwendet wurde, angeben.

-StorageLocation <string>

Gibt den Datenbankspeicherort an. Dies ist der Speicherort der Datenbankdateien im Dateisystem. Legen Sie diesen Parameter fest, wenn Sie nicht den Standardspeicherort verwenden (den Sicherungsordner der Zielinstanz).

-Server <string>

Gibt die Analysis Services-Instanz an, zu der das Cmdlet eine Verbindung herstellt und auf der es ausgeführt wird. Wenn kein Servername angegeben wird, wird eine Verbindung mit localhost hergestellt. Für Standardinstanzen geben Sie nur den Servernamen an. Verwenden Sie für benannte Instanzen das Format "servername\instanzenname". Verwenden Sie für HTTP-Verbindungen das Format "http[s]://server[:port]/virtualdirectory/msmdpump.dll".

-Credential <PSCredential>

Gibt ein PSCredential-Objekt an, das einen Windows-Benutzernamen und ein -Kennwort angegeben werden. Geben Sie diesen Parameter nur an, wenn die Analysis Services-Instanz mit der Standardauthentifizierung für HTTP-Zugriff konfiguriert wird. Für systemeigene Verbindungen, die integrierte Sicherheit verwenden, wird dieser Parameter ignoriert.

Wenn dieser Parameter vorhanden ist, werden die Anmeldeinformationen, die es bereitstellt, an die Verbindungszeichenfolge angefügt. Beim Herstellen einer Verbindung mit Analysis Services wird die Identität dieses Benutzers dann von IIS angenommen. Wenn keine Anmeldeinformationen angegeben sind, wird das Windows-Standardkonto des Benutzers, der das Tool ausführt, verwendet.

Um diesen Parameter zu verwenden, erstellen Sie zuerst mit Get-Credential ein PSCredential-Objekt, um den Benutzernamen und das Kennwort anzugeben (z. B. $Cred=Get-Credential “adventure-works\admin”). Sie können dann dieses Objekt an den –Credential-Parameter (-Credential:$Cred weitergeben.

Weitere Informationen über Authentifizierung und die Verwendung von Anmeldeinformationen finden Sie unter Analysis Services PowerShell. Weitere Informationen zum HTTP-Zugriff finden Sie unter Konfigurieren von HTTP-Zugriff auf Analysis Services unter Internetinformationsdienste (IIS) 7.0.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter About_CommonParameters.

Eingaben und Ausgaben

Mit dem Eingabetyp wird festgelegt, welchen Typ von Objekten Sie über die Pipeline an das Cmdlet übergeben können. Der Rückgabetyp bezeichnet den Typ der vom Cmdlet zurückgegebenen Objekte.

Beispiel 1

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

Dieser Befehl stellt eine Analysis Services-Sicherungsdatei ("awtest.abf") im lokalen Sicherungsordner der Standardinstanz in einer lokalen Analysis Services wieder her. Der Datenbankname muss nicht vorhanden sein; in diesem Fall wird der Datenbankname als Teil des Wiederherstellungsvorgangs angegeben. Wenn Sie "-Security:CopyAll" hinzufügen, werden Rollen und Rollenmitgliedschaften aus der Sicherungsdatenbank in der neu wiederhergestellten Datenbank aufgefüllt.

Beispiel 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

Linie 1 und 2 werden verwendet, um das Kennwort aufzufordern, das verwendet wurde, die Datei zu verschlüsseln.

Linie 3 stellt eine verschlüsselte Analysis Services-Sicherungsdatei (testdb.abf) von einem Remotesicherungsordner auf einer Analysis Services-Standardinstanz wieder her.

Mit Linie 4 und 5 wird das Kennwort entfernt.

Beispiel 3

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

Dieser Befehl stellt eine verschlüsselte Analysis Services-Sicherungsdatei (testdb.abf) in einem Remotesicherungsordner auf einer Remote-Analysis Services Standardinstanz wieder her. Der –StorageLocations-Parameter wird verwendet, um die Datenbankdateien an einem nicht standardmäßigen Speicherort einzufügen, in diesem Fall eine freigegebene Datei mit dem Namen "restoreDBfiles".

Siehe auch

Konzepte

Analysis Services PowerShell

Andere Ressourcen

Verwalten von tabellarischen Modellen mit PowerShell